Annotation of libwww/Library/src/HTHost.c, revision 2.63
2.1 frystyk 1: /* HTHost.c
2: ** REMOTE HOST INFORMATION
3: **
4: ** (c) COPYRIGHT MIT 1995.
5: ** Please first read the full copyright statement in the file COPYRIGH.
2.63 ! frystyk 6: ** @(#) $Id: HTHost.c,v 2.62 1999/03/31 19:48:21 frystyk Exp $
2.1 frystyk 7: **
8: ** This object manages the information that we know about a remote host.
9: ** This can for example be what type of host it is, and what version
10: ** it is using. We also keep track of persistent connections
11: **
12: ** April 96 HFN Written
13: */
14:
15: /* Library include files */
2.44 frystyk 16: #include "wwwsys.h"
2.1 frystyk 17: #include "WWWUtil.h"
18: #include "HTParse.h"
19: #include "HTAlert.h"
20: #include "HTError.h"
21: #include "HTNetMan.h"
22: #include "HTTrans.h"
2.13 frystyk 23: #include "HTTPUtil.h"
24: #include "HTTCP.h"
2.1 frystyk 25: #include "HTHost.h" /* Implemented here */
2.13 frystyk 26: #include "HTHstMan.h"
2.1 frystyk 27:
2.48 frystyk 28: #define HOST_OBJECT_TTL 43200L /* Default host timeout is 12 h */
2.29 frystyk 29:
2.48 frystyk 30: #define TCP_IDLE_PASSIVE 120L /* Passive TTL in s on an idle connection */
31: #define TCP_IDLE_ACTIVE 60000L /* Active TTL in ms on an idle connection */
2.29 frystyk 32:
2.45 frystyk 33: #define MAX_PIPES 50 /* maximum number of pipelined requests */
2.50 frystyk 34: #define MAX_HOST_RECOVER 1 /* Max number of auto recovery */
2.32 frystyk 35: #define DEFAULT_DELAY 30 /* Default write flush delay in ms */
2.1 frystyk 36:
2.13 frystyk 37: struct _HTInputStream {
38: const HTInputStreamClass * isa;
2.1 frystyk 39: };
40:
2.13 frystyk 41: PRIVATE int HostEvent(SOCKET soc, void * pVoid, HTEventType type);
42:
43: /* Type definitions and global variables etc. local to this module */
2.48 frystyk 44: PRIVATE time_t HostTimeout = HOST_OBJECT_TTL; /* Timeout for host objects */
2.53 frystyk 45: PRIVATE time_t HTPassiveTimeout = TCP_IDLE_PASSIVE; /* Passive timeout in s */
46: PRIVATE ms_t HTActiveTimeout = TCP_IDLE_ACTIVE; /* Active timeout in ms */
2.1 frystyk 47:
2.8 frystyk 48: PRIVATE HTList ** HostTable = NULL;
49: PRIVATE HTList * PendHost = NULL; /* List of pending host elements */
2.1 frystyk 50:
2.40 kahan 51: /* JK: New functions for interruption the automatic pending request
52: activation */
53: PRIVATE HTHost_ActivateRequestCallback * ActivateReqCBF = NULL;
54: PRIVATE int HTHost_ActivateRequest (HTNet *net);
55: PRIVATE BOOL DoPendingReqLaunch = YES; /* controls automatic activation
56: of pending requests */
57:
2.13 frystyk 58: PRIVATE int EventTimeout = -1; /* Global Host event timeout */
59:
2.36 frystyk 60: PRIVATE ms_t WriteDelay = DEFAULT_DELAY; /* Delay in ms */
2.26 frystyk 61:
2.45 frystyk 62: PRIVATE int MaxPipelinedRequests = MAX_PIPES;
63:
2.1 frystyk 64: /* ------------------------------------------------------------------------- */
65:
66: PRIVATE void free_object (HTHost * me)
67: {
68: if (me) {
2.30 frystyk 69: int i;
2.1 frystyk 70: HT_FREE(me->hostname);
71: HT_FREE(me->type);
2.12 frystyk 72: HT_FREE(me->server);
73: HT_FREE(me->user_agent);
74: HT_FREE(me->range_units);
2.30 frystyk 75:
76: /* Delete the channel (if any) */
2.3 eric 77: if (me->channel) {
2.5 eric 78: HTChannel_delete(me->channel, HT_OK);
2.3 eric 79: me->channel = NULL;
80: }
2.30 frystyk 81:
82: /* Unregister the events */
2.18 eric 83: for (i = 0; i < HTEvent_TYPES; i++)
84: HTEvent_delete(me->events[i]);
2.30 frystyk 85:
86: /* Delete the timer (if any) */
87: if (me->timer) HTTimer_delete(me->timer);
88:
89: /* Delete the queues */
2.8 frystyk 90: HTList_delete(me->pipeline);
91: HTList_delete(me->pending);
2.1 frystyk 92: HT_FREE(me);
93: }
94: }
95:
96: PRIVATE BOOL delete_object (HTList * list, HTHost * me)
97: {
2.59 frystyk 98: HTTRACE(CORE_TRACE, "Host info... object %p from list %p\n" _ me _ list);
2.1 frystyk 99: HTList_removeObject(list, (void *) me);
100: free_object(me);
101: return YES;
102: }
103:
2.13 frystyk 104: PRIVATE BOOL isLastInPipe (HTHost * host, HTNet * net)
105: {
106: return HTList_lastObject(host->pipeline) == net;
107: }
108:
2.51 frystyk 109: PRIVATE BOOL killPipeline (HTHost * host, HTEventType type)
2.48 frystyk 110: {
111: if (host) {
112: int piped = HTList_count(host->pipeline);
113: int pending = HTList_count(host->pending);
114: int cnt;
115:
2.59 frystyk 116: HTTRACE(CORE_TRACE, "Host kill... Pipeline due to %s event\n" _ HTEvent_type2str(type));
2.51 frystyk 117:
2.48 frystyk 118: /* Terminate all net objects in pending queue */
119: for (cnt=0; cnt<pending; cnt++) {
120: HTNet * net = HTList_removeLastObject(host->pending);
2.56 frystyk 121: if (net) {
2.59 frystyk 122: HTTRACE(CORE_TRACE, "Host kill... Terminating net object %p from pending queue\n" _ net);
2.56 frystyk 123: net->registeredFor = 0;
124: (*net->event.cbf)(HTChannel_socket(host->channel), net->event.param, type);
2.58 frystyk 125: if (host->lock == net) host->lock = NULL;
2.56 frystyk 126: }
2.48 frystyk 127: }
128:
129: /* Terminate all net objects in pipeline */
130: if (piped >= 1) {
131:
132: /*
133: ** Terminte all net objects in the pipeline
134: */
135: for (cnt=0; cnt<piped; cnt++) {
136: HTNet * net = HTList_firstObject(host->pipeline);
2.56 frystyk 137: if (net) {
2.59 frystyk 138: HTTRACE(CORE_TRACE, "Host kill... Terminating net object %p from pipe line\n" _ net);
2.56 frystyk 139: net->registeredFor = 0;
140: (*net->event.cbf)(HTChannel_socket(host->channel), net->event.param, type);
141: }
2.48 frystyk 142: }
143: }
144: return YES;
145: }
146: return NO;
147: }
148:
149: /*
2.51 frystyk 150: ** Silently close an idle persistent connection after
2.53 frystyk 151: ** HTActiveTimeout secs
2.51 frystyk 152: */
153: PRIVATE int IdleTimeoutEvent (HTTimer * timer, void * param, HTEventType type)
154: {
155: HTHost * host = (HTHost *) param;
156: SOCKET sockfd = HTChannel_socket(host->channel);
157: int result = HostEvent (sockfd, host, HTEvent_CLOSE);
158: HTTimer_delete(timer);
159: host->timer = NULL;
160: return result;
161: }
162:
163: /*
2.13 frystyk 164: ** HostEvent - host event manager - recieves events from the event
165: ** manager and dispatches them to the client net objects by calling the
166: ** net object's cbf.
167: **
168: */
169: PRIVATE int HostEvent (SOCKET soc, void * pVoid, HTEventType type)
170: {
171: HTHost * host = (HTHost *)pVoid;
172:
2.61 frystyk 173: if (type == HTEvent_READ || type == HTEvent_CLOSE || type == HTEvent_ACCEPT) {
2.13 frystyk 174: HTNet * targetNet;
175:
176: /* call the first net object */
177: do {
178: int ret;
2.49 frystyk 179:
180: /* netscape and apache servers can do a lazy close well after usage
181: * of previous socket has been dispensed by the library,
182: * the section below makes sure the event does not get miss attributed
183: */
184: if (HTChannel_socket(host->channel) != soc) {
2.59 frystyk 185: HTTRACE(CORE_TRACE, "Host Event.. wild socket %d type = %s real socket is %d\n" _ soc _
186: type == HTEvent_CLOSE ? "Event_Close" : "Event_Read" _
2.49 frystyk 187: HTChannel_socket(host->channel));
188: return HT_OK;
189: }
190:
2.13 frystyk 191: targetNet = (HTNet *)HTList_firstObject(host->pipeline);
192: if (targetNet) {
2.59 frystyk 193: HTTRACE(CORE_TRACE, "Host Event.. READ passed to `%s\'\n" _
2.28 frystyk 194: HTAnchor_physical(HTRequest_anchor(HTNet_request(targetNet))));
2.13 frystyk 195: if ((ret = (*targetNet->event.cbf)(HTChannel_socket(host->channel),
196: targetNet->event.param, type)) != HT_OK)
197: return ret;
198: }
199: if (targetNet == NULL && host->remainingRead > 0) {
2.59 frystyk 200: HTTRACE(CORE_TRACE, "HostEvent... Error: %d bytes left to read and nowhere to put them\n" _
2.31 frystyk 201: host->remainingRead);
2.13 frystyk 202: host->remainingRead = 0;
203: /*
204: ** Fall through to close the channel
205: */
206: }
207: /* call pipelined net object to eat all the data in the channel */
208: } while (host->remainingRead > 0);
209:
210: /* last target net should have set remainingRead to 0 */
211: if (targetNet)
212: return HT_OK;
213:
214: /* If there was notargetNet, it should be a close */
2.59 frystyk 215: HTTRACE(CORE_TRACE, "Host Event.. host %p `%s\' closed connection.\n" _
216: host _ host->hostname);
2.13 frystyk 217:
218: /* Is there garbage in the channel? Let's check: */
219: {
220: char buf[256];
221: int ret;
2.28 frystyk 222: memset(buf, '\0', sizeof(buf));
2.48 frystyk 223: while ((ret = NETREAD(HTChannel_socket(host->channel), buf, sizeof(buf)-1)) > 0) {
2.59 frystyk 224: HTTRACE(CORE_TRACE, "Host Event.. Host %p `%s\' had %d extraneous bytes: `%s\'\n" _
225: host _ host->hostname _ ret _ buf);
2.28 frystyk 226: memset(buf, '\0', sizeof(buf));
227: }
2.13 frystyk 228: }
229: HTHost_clearChannel(host, HT_OK);
2.28 frystyk 230: return HT_OK; /* extra garbage does not constitute an application error */
2.13 frystyk 231:
2.18 eric 232: } else if (type == HTEvent_WRITE || type == HTEvent_CONNECT) {
2.13 frystyk 233: HTNet * targetNet = (HTNet *)HTList_lastObject(host->pipeline);
234: if (targetNet) {
2.59 frystyk 235: HTTRACE(CORE_TRACE, "Host Event.. WRITE passed to `%s\'\n" _
2.28 frystyk 236: HTAnchor_physical(HTRequest_anchor(HTNet_request(targetNet))));
2.13 frystyk 237: return (*targetNet->event.cbf)(HTChannel_socket(host->channel), targetNet->event.param, type);
238: }
2.59 frystyk 239: HTTRACE(CORE_TRACE, "Host Event Host %p (`%s\') dispatched with event %s but doesn't have a target - %d requests made, %d requests in pipe, %d pending\n" _
240: host _
241: host ? host->hostname : "<null>" _
242: HTEvent_type2str(type) _
243: host ? host->reqsMade : -1 _
244: HTList_count(host->pipeline) _
2.56 frystyk 245: HTList_count(host->pending));
2.55 frystyk 246: #if 0
2.59 frystyk 247: HTDEBUGBREAK("Host Event.. Host %p (`%s\') dispatched with event %d\n" _
248: host _ host ? host->hostname : "<null>" _ type);
2.13 frystyk 249: return HT_ERROR;
2.55 frystyk 250: #else
251: return HT_OK;
252: #endif
2.14 frystyk 253: } else if (type == HTEvent_TIMEOUT) {
2.51 frystyk 254: killPipeline(host, HTEvent_TIMEOUT);
2.14 frystyk 255: } else {
2.59 frystyk 256: HTTRACE(CORE_TRACE, "Don't know how to handle OOB data from `%s\'?\n" _
2.44 frystyk 257: host->hostname);
2.14 frystyk 258: }
2.13 frystyk 259: return HT_OK;
260: }
261:
2.1 frystyk 262: /*
263: ** Search the host info cache for a host object or create a new one
264: ** and add it. Examples of host names are
265: **
266: ** www.w3.org
267: ** www.foo.com:8000
268: ** 18.52.0.18
269: **
270: ** Returns Host object or NULL if error. You may get back an already
271: ** existing host object - you're not guaranteed a new one each time.
272: */
2.15 eric 273: PUBLIC HTHost * HTHost_new (char * host, u_short u_port)
2.1 frystyk 274: {
275: HTList * list = NULL; /* Current list in cache */
276: HTHost * pres = NULL;
2.13 frystyk 277: int hash = 0;
2.1 frystyk 278: if (!host) {
2.59 frystyk 279: HTTRACE(CORE_TRACE, "Host info... Bad argument\n");
2.1 frystyk 280: return NULL;
281: }
282:
283: /* Find a hash for this host */
284: {
285: char *ptr;
286: for (ptr=host; *ptr; ptr++)
2.13 frystyk 287: hash = (int) ((hash * 3 + (*(unsigned char *) ptr)) % HOST_HASH_SIZE);
2.1 frystyk 288: if (!HostTable) {
2.13 frystyk 289: if ((HostTable = (HTList **) HT_CALLOC(HOST_HASH_SIZE,
2.1 frystyk 290: sizeof(HTList *))) == NULL)
291: HT_OUTOFMEM("HTHost_find");
292: }
293: if (!HostTable[hash]) HostTable[hash] = HTList_new();
294: list = HostTable[hash];
295: }
296:
297: /* Search the cache */
298: {
299: HTList * cur = list;
300: while ((pres = (HTHost *) HTList_nextObject(cur))) {
2.15 eric 301: if (!strcmp(pres->hostname, host) && u_port == pres->u_port) {
2.8 frystyk 302: if (HTHost_isIdle(pres) && time(NULL)>pres->ntime+HostTimeout){
2.59 frystyk 303: HTTRACE(CORE_TRACE, "Host info... Collecting host info %p\n" _ pres);
2.1 frystyk 304: delete_object(list, pres);
305: pres = NULL;
306: }
307: break;
308: }
309: }
310: }
311:
2.8 frystyk 312: /* If not found then create new Host object, else use existing one */
2.1 frystyk 313: if (pres) {
314: if (pres->channel) {
2.32 frystyk 315:
316: /*
317: ** If we have a TTL for this TCP connection then
318: ** check that we haven't passed it.
319: */
320: if (pres->expires > 0) {
321: time_t t = time(NULL);
2.51 frystyk 322: if (HTHost_isIdle(pres) && pres->expires < t) {
2.59 frystyk 323: HTTRACE(CORE_TRACE, "Host info... Persistent channel %p gotten cold\n" _
2.32 frystyk 324: pres->channel);
2.48 frystyk 325: HTHost_clearChannel(pres, HT_OK);
2.32 frystyk 326: } else {
2.53 frystyk 327: pres->expires = t + HTPassiveTimeout;
2.59 frystyk 328: HTTRACE(CORE_TRACE, "Host info... REUSING CHANNEL %p\n" _ pres->channel);
2.32 frystyk 329: }
330: }
2.55 frystyk 331: } else {
2.59 frystyk 332: HTTRACE(CORE_TRACE, "Host info... Found Host %p with no active channel\n" _ pres);
2.1 frystyk 333: }
334: } else {
335: if ((pres = (HTHost *) HT_CALLOC(1, sizeof(HTHost))) == NULL)
336: HT_OUTOFMEM("HTHost_add");
2.13 frystyk 337: pres->hash = hash;
2.1 frystyk 338: StrAllocCopy(pres->hostname, host);
2.15 eric 339: pres->u_port = u_port;
2.1 frystyk 340: pres->ntime = time(NULL);
2.8 frystyk 341: pres->mode = HT_TP_SINGLE;
2.26 frystyk 342: pres->delay = WriteDelay;
2.18 eric 343: {
2.26 frystyk 344: int i;
345: for (i = 0; i < HTEvent_TYPES; i++)
346: pres->events[i]= HTEvent_new(HostEvent, pres, HT_PRIORITY_MAX, EventTimeout);
2.18 eric 347: }
2.59 frystyk 348: HTTRACE(CORE_TRACE, "Host info... added `%s\' with host %p to list %p\n" _
349: host _ pres _ list);
2.1 frystyk 350: HTList_addObject(list, (void *) pres);
351: }
352: return pres;
2.9 frystyk 353: }
354:
2.15 eric 355: PUBLIC HTHost * HTHost_newWParse (HTRequest * request, char * url, u_short u_port)
2.13 frystyk 356: {
2.32 frystyk 357: char * port;
358: char * fullhost = NULL;
359: char * parsedHost = NULL;
360: SockA * sin;
361: HTHost * me;
362: char * proxy = HTRequest_proxy(request);
2.13 frystyk 363:
2.32 frystyk 364: fullhost = HTParse(proxy ? proxy : url, "", PARSE_HOST);
2.13 frystyk 365:
366: /* If there's an @ then use the stuff after it as a hostname */
2.32 frystyk 367: if (fullhost) {
368: char * at_sign;
369: if ((at_sign = strchr(fullhost, '@')) != NULL)
370: parsedHost = at_sign+1;
371: else
372: parsedHost = fullhost;
373: }
374: if (!parsedHost || !*parsedHost) {
375: HTRequest_addError(request, ERR_FATAL, NO, HTERR_NO_HOST,
2.52 frystyk 376: NULL, 0, "HTHost_newWParse");
2.32 frystyk 377: HT_FREE(fullhost);
378: return NULL;
379: }
2.55 frystyk 380:
381: /* See if the default port should be overridden */
382: if ((port = strchr(parsedHost, ':')) != NULL) {
2.32 frystyk 383: *port++ = '\0';
2.55 frystyk 384: if (*port && isdigit((int) *port)) u_port = (u_short) atol(port);
2.32 frystyk 385: }
2.59 frystyk 386: HTTRACE(PROT_TRACE, "HTHost parse Looking up `%s\' on port %u\n" _ parsedHost _ u_port);
2.55 frystyk 387:
2.32 frystyk 388: /* Find information about this host */
389: if ((me = HTHost_new(parsedHost, u_port)) == NULL) {
2.59 frystyk 390: HTTRACE(PROT_TRACE, "HTHost parse Can't get host info\n");
2.32 frystyk 391: me->tcpstate = TCP_ERROR;
392: return NULL;
393: }
394: sin = &me->sock_addr;
395: memset((void *) sin, '\0', sizeof(SockA));
2.13 frystyk 396: #ifdef DECNET
2.32 frystyk 397: sin->sdn_family = AF_DECnet;
398: net->sock_addr.sdn_objnum = port ? (unsigned char)(strtol(port, (char **) 0, 10)) : DNP_OBJ;
2.13 frystyk 399: #else /* Internet */
2.32 frystyk 400: sin->sin_family = AF_INET;
401: sin->sin_port = htons(u_port);
2.13 frystyk 402: #endif
2.32 frystyk 403: HT_FREE(fullhost); /* parsedHost points into fullhost */
404: return me;
2.13 frystyk 405: }
406:
2.9 frystyk 407: /*
408: ** Search the host info cache for a host object. Examples of host names:
409: **
410: ** www.w3.org
411: ** www.foo.com:8000
412: ** 18.52.0.18
413: **
414: ** Returns Host object or NULL if not found.
415: */
416: PUBLIC HTHost * HTHost_find (char * host)
417: {
418: HTList * list = NULL; /* Current list in cache */
419: HTHost * pres = NULL;
2.59 frystyk 420: HTTRACE(CORE_TRACE, "Host info... Looking for `%s\'\n" _ host ? host : "<null>");
2.9 frystyk 421:
422: /* Find a hash for this host */
423: if (host && HostTable) {
424: int hash = 0;
425: char *ptr;
426: for (ptr=host; *ptr; ptr++)
2.13 frystyk 427: hash = (int) ((hash * 3 + (*(unsigned char *) ptr)) % HOST_HASH_SIZE);
2.9 frystyk 428: if (!HostTable[hash]) return NULL;
429: list = HostTable[hash];
430:
431: /* Search the cache */
432: {
433: HTList * cur = list;
434: while ((pres = (HTHost *) HTList_nextObject(cur))) {
435: if (!strcmp(pres->hostname, host)) {
436: if (time(NULL) > pres->ntime + HostTimeout) {
2.59 frystyk 437: HTTRACE(CORE_TRACE, "Host info... Collecting host %p\n" _ pres);
2.9 frystyk 438: delete_object(list, pres);
439: pres = NULL;
440: } else {
2.59 frystyk 441: HTTRACE(CORE_TRACE, "Host info... Found `%s\'\n" _ host);
2.9 frystyk 442: }
443: return pres;
444: }
445: }
446: }
447: }
448: return NULL;
2.1 frystyk 449: }
450:
451: /*
2.62 frystyk 452: ** Cleanup the host list
453: */
454: PUBLIC void HTHost_deleteAll (void)
455: {
456: HTList * list;
457: HTHost * host;
458: int i;
459:
460: if (!HostTable)
461: return;
462:
463: for (i=0; i < HOST_HASH_SIZE; i++) {
464: list = HostTable[i];
465: if (!list) continue;
466:
467: while ((host = (HTHost *) HTList_removeFirstObject(list)) != NULL)
468: free_object(host);
469:
470: HTList_delete(list);
471: }
472:
473: HT_FREE(HostTable);
474: HostTable = NULL;
475: }
476:
477: /*
2.8 frystyk 478: ** Get and set the hostname of the remote host
479: */
480: PUBLIC char * HTHost_name (HTHost * host)
481: {
482: return host ? host->hostname : NULL;
483: }
484:
485: /*
2.1 frystyk 486: ** Get and set the type class of the remote host
487: */
488: PUBLIC char * HTHost_class (HTHost * host)
489: {
490: return host ? host->type : NULL;
491: }
492:
493: PUBLIC void HTHost_setClass (HTHost * host, char * s_class)
494: {
495: if (host && s_class) StrAllocCopy(host->type, s_class);
496: }
497:
498: /*
499: ** Get and set the version of the remote host
500: */
501: PUBLIC int HTHost_version (HTHost *host)
502: {
503: return host ? host->version : 0;
504: }
505:
506: PUBLIC void HTHost_setVersion (HTHost * host, int version)
507: {
508: if (host) host->version = version;
509: }
510:
511: /*
2.53 frystyk 512: ** Get and set the passive timeout for persistent entries.
2.1 frystyk 513: */
2.53 frystyk 514: PUBLIC BOOL HTHost_setPersistTimeout (time_t timeout)
2.1 frystyk 515: {
2.53 frystyk 516: if (timeout > 0) {
517: HTPassiveTimeout = timeout;
518: return YES;
519: }
520: return NO;
521: }
522:
523: PUBLIC time_t HTHost_persistTimeout (void)
524: {
525: return HTPassiveTimeout;
526: }
527:
528: /*
529: ** Get and set the active timeout for persistent entries.
530: */
531: PUBLIC BOOL HTHost_setActiveTimeout (ms_t timeout)
532: {
533: if (timeout > 1000) {
534: HTActiveTimeout = timeout;
535: return YES;
536: }
537: return NO;
2.1 frystyk 538: }
539:
2.53 frystyk 540: PUBLIC ms_t HTHost_activeTimeout (void)
2.1 frystyk 541: {
2.53 frystyk 542: return HTActiveTimeout;
2.1 frystyk 543: }
544:
545: /* Persistent Connection Expiration
546: ** --------------------------------
547: ** Should normally not be used. If, then use calendar time.
548: */
549: PUBLIC void HTHost_setPersistExpires (HTHost * host, time_t expires)
550: {
551: if (host) host->expires = expires;
552: }
553:
554: PUBLIC time_t HTHost_persistExpires (HTHost * host)
555: {
556: return host ? host->expires : -1;
557: }
558:
2.22 eric 559: PUBLIC void HTHost_setReqsPerConnection (HTHost * host, int reqs)
560: {
561: if (host) host->reqsPerConnection = reqs;
562: }
563:
564: PUBLIC int HTHost_reqsPerConnection (HTHost * host)
565: {
566: return host ? host->reqsPerConnection : -1;
567: }
568:
569: PUBLIC void HTHost_setReqsMade (HTHost * host, int reqs)
570: {
571: if (host) host->reqsMade = reqs;
572: }
573:
574: PUBLIC int HTHost_reqsMade (HTHost * host)
575: {
576: return host ? host->reqsMade : -1;
577: }
578:
2.1 frystyk 579: /*
2.6 frystyk 580: ** Public methods for this host
581: */
582: PUBLIC HTMethod HTHost_publicMethods (HTHost * me)
583: {
584: return me ? me->methods : METHOD_INVALID;
585: }
586:
587: PUBLIC void HTHost_setPublicMethods (HTHost * me, HTMethod methodset)
588: {
589: if (me) me->methods = methodset;
590: }
591:
592: PUBLIC void HTHost_appendPublicMethods (HTHost * me, HTMethod methodset)
593: {
594: if (me) me->methods |= methodset;
595: }
596:
597: /*
598: ** Get and set the server name of the remote host
599: */
600: PUBLIC char * HTHost_server (HTHost * host)
601: {
602: return host ? host->server : NULL;
603: }
604:
605: PUBLIC BOOL HTHost_setServer (HTHost * host, const char * server)
606: {
607: if (host && server) {
608: StrAllocCopy(host->server, server);
609: return YES;
610: }
611: return NO;
612: }
613:
614: /*
615: ** Get and set the userAgent name of the remote host
616: */
617: PUBLIC char * HTHost_userAgent (HTHost * host)
618: {
619: return host ? host->user_agent : NULL;
620: }
621:
622: PUBLIC BOOL HTHost_setUserAgent (HTHost * host, const char * userAgent)
623: {
624: if (host && userAgent) {
625: StrAllocCopy(host->user_agent, userAgent);
626: return YES;
2.12 frystyk 627: }
628: return NO;
629: }
630:
631: /*
632: ** Get and set acceptable range units
633: */
634: PUBLIC char * HTHost_rangeUnits (HTHost * host)
635: {
636: return host ? host->range_units : NULL;
637: }
638:
639: PUBLIC BOOL HTHost_setRangeUnits (HTHost * host, const char * units)
640: {
641: if (host && units) {
642: StrAllocCopy(host->range_units, units);
643: return YES;
644: }
645: return NO;
646: }
647:
648: /*
649: ** Checks whether a specific range unit is OK. We always say
650: ** YES except if we have a specific statement from the server that
651: ** it doesn't understand byte ranges - that is - it has sent "none"
652: ** in a "Accept-Range" response header
653: */
654: PUBLIC BOOL HTHost_isRangeUnitAcceptable (HTHost * host, const char * unit)
655: {
656: if (host && unit) {
657: #if 0
658: if (host->range_units) {
2.63 ! frystyk 659: char * start = HTStrCaseStr(host->range_units, "none");
2.12 frystyk 660:
661: /*
662: ** Check that "none" is infact a token. It could be part of some
663: ** other valid string, so we'd better check for it.
664: */
665: if (start) {
666:
667:
668: }
669: return NO;
670: }
671: #endif
672: return strcasecomp(unit, "bytes") ? NO : YES;
2.6 frystyk 673: }
674: return NO;
675: }
676:
2.1 frystyk 677: /*
678: ** As soon as we know that this host accepts persistent connections,
679: ** we associated the channel with the host.
680: ** We don't want more than MaxSockets-2 connections to be persistent in
681: ** order to avoid deadlock.
682: */
2.13 frystyk 683: PUBLIC BOOL HTHost_setPersistent (HTHost * host,
684: BOOL persistent,
685: HTTransportMode mode)
2.1 frystyk 686: {
2.13 frystyk 687: if (!host) return NO;
688:
689: if (!persistent) {
690: /*
691: ** We use the HT_IGNORE status code as we don't want to free
692: ** the stream at this point in time. The situation we want to
693: ** avoid is that we free the channel from within the stream pipe.
694: ** This will lead to an infinite look having the stream freing
695: ** itself.
696: */
2.30 frystyk 697: host->persistent = NO;
2.13 frystyk 698: return HTHost_clearChannel(host, HT_IGNORE);
699: }
700:
2.18 eric 701: /*
702: ** Set the host persistent if not already. Also update the mode to
703: ** the new one - it may have changed
704: */
705: HTHost_setMode(host, mode);
706: if (!host->persistent) {
2.13 frystyk 707: SOCKET sockfd = HTChannel_socket(host->channel);
2.8 frystyk 708: if (sockfd != INVSOC && HTNet_availablePersistentSockets() > 0) {
2.13 frystyk 709: host->persistent = YES;
2.53 frystyk 710: host->expires = time(NULL) + HTPassiveTimeout; /* Default timeout */
2.13 frystyk 711: HTChannel_setHost(host->channel, host);
2.8 frystyk 712: HTNet_increasePersistentSocket();
2.59 frystyk 713: HTTRACE(CORE_TRACE, "Host info... added host %p as persistent\n" _ host);
2.1 frystyk 714: return YES;
715: } else {
2.59 frystyk 716: HTTRACE(CORE_TRACE, "Host info... no room for persistent socket %d\n" _
2.7 frystyk 717: sockfd);
2.18 eric 718: return NO;
2.1 frystyk 719: }
2.18 eric 720: } else {
2.59 frystyk 721: HTTRACE(CORE_TRACE, "Host info... %p already persistent\n" _ host);
2.18 eric 722: return YES;
2.1 frystyk 723: }
724: return NO;
725: }
726:
727: /*
2.13 frystyk 728: ** Check whether we have a persistent channel or not
729: */
730: PUBLIC BOOL HTHost_isPersistent (HTHost * host)
731: {
732: return host && host->persistent;
733: }
734:
735: /*
2.1 frystyk 736: ** Find persistent channel associated with this host.
737: */
738: PUBLIC HTChannel * HTHost_channel (HTHost * host)
739: {
740: return host ? host->channel : NULL;
741: }
742:
2.30 frystyk 743:
2.1 frystyk 744: /*
2.30 frystyk 745: ** Check whether we have got a "close" notification, for example in the
746: ** connection header
747: */
748: PUBLIC BOOL HTHost_setCloseNotification (HTHost * host, BOOL mode)
749: {
750: if (host) {
751: host->close_notification = mode;
2.37 frystyk 752: return YES;
2.30 frystyk 753: }
754: return NO;
755: }
756:
757: PUBLIC BOOL HTHost_closeNotification (HTHost * host)
758: {
759: return host && host->close_notification;
760: }
761:
762: /*
2.1 frystyk 763: ** Clear the persistent entry by deleting the channel object. Note that
764: ** the channel object is only deleted if it's not used anymore.
765: */
2.8 frystyk 766: PUBLIC BOOL HTHost_clearChannel (HTHost * host, int status)
2.1 frystyk 767: {
768: if (host && host->channel) {
2.8 frystyk 769: HTChannel_setHost(host->channel, NULL);
2.10 frystyk 770:
2.13 frystyk 771: HTEvent_unregister(HTChannel_socket(host->channel), HTEvent_READ);
772: HTEvent_unregister(HTChannel_socket(host->channel), HTEvent_WRITE);
2.18 eric 773: host->registeredFor = 0;
2.13 frystyk 774:
2.10 frystyk 775: /*
776: ** We don't want to recursively delete ourselves so if we are
777: ** called from within the stream pipe then don't delete the channel
778: ** at this point
779: */
2.8 frystyk 780: HTChannel_delete(host->channel, status);
2.18 eric 781: host->expires = 0;
2.1 frystyk 782: host->channel = NULL;
2.22 eric 783: host->tcpstate = TCP_BEGIN;
784: host->reqsMade = 0;
2.32 frystyk 785: if (HTHost_isPersistent(host)) {
786: HTNet_decreasePersistentSocket();
787: host->persistent = NO;
788: }
789: host->close_notification = NO;
2.45 frystyk 790: host->broken_pipe = NO;
2.32 frystyk 791: host->mode = HT_TP_SINGLE;
792:
2.59 frystyk 793: HTTRACE(CORE_TRACE, "Host info... removed host %p as persistent\n" _ host);
2.32 frystyk 794:
795: if (!HTList_isEmpty(host->pending)) {
2.59 frystyk 796: HTTRACE(CORE_TRACE, "Host has %d object(s) pending - attempting launch\n" _ HTList_count(host->pending));
2.32 frystyk 797: HTHost_launchPending(host);
798: }
2.1 frystyk 799: return YES;
800: }
801: return NO;
802: }
803:
2.37 frystyk 804: PUBLIC BOOL HTHost_doRecover (HTHost * host)
805: {
806: return host ? host->do_recover : NO;
807: }
808:
2.1 frystyk 809: /*
2.18 eric 810: ** Move all entries in the pipeline and move the rest to the pending
811: ** queue. They will get launched at a later point in time.
812: */
813: PUBLIC BOOL HTHost_recoverPipe (HTHost * host)
814: {
815: if (host) {
816: int piped = HTList_count(host->pipeline);
817: if (piped > 0) {
818: int cnt;
2.24 frystyk 819: host->recovered++;
2.59 frystyk 820: HTTRACE(CORE_TRACE, "Host recovered %d times. Moving %d Net objects from pipe line to pending queue\n" _
821: host->recovered _ piped);
2.18 eric 822:
823: /*
824: ** Unregister this host for all events
825: */
826: HTEvent_unregister(HTChannel_socket(host->channel), HTEvent_READ);
827: HTEvent_unregister(HTChannel_socket(host->channel), HTEvent_WRITE);
828: host->registeredFor = 0;
829:
830: /*
831: ** Set new mode to single until we know what is going on
832: */
833: host->mode = HT_TP_SINGLE;
834:
835: /*
836: ** Move all net objects from the net object to the pending queue.
837: */
838: if (!host->pending) host->pending = HTList_new();
839: for (cnt=0; cnt<piped; cnt++) {
840: HTNet * net = HTList_removeLastObject(host->pipeline);
2.59 frystyk 841: HTTRACE(CORE_TRACE, "Host recover Resetting net object %p\n" _ net);
2.18 eric 842: net->registeredFor = 0;
843: (*net->event.cbf)(HTChannel_socket(host->channel), net->event.param, HTEvent_RESET);
844: HTList_appendObject(host->pending, net);
2.57 frystyk 845: host->lock = net;
2.18 eric 846: }
2.37 frystyk 847:
2.18 eric 848: HTChannel_setSemaphore(host->channel, 0);
849: HTHost_clearChannel(host, HT_INTERRUPTED);
2.37 frystyk 850: host->do_recover = NO;
2.18 eric 851: }
2.24 frystyk 852: return YES;
2.18 eric 853: }
854: return NO;
855: }
856:
857: /*
2.51 frystyk 858: ** Terminate a pipeline prematurely, for example because of timeout,
859: ** interruption, etc.
860: */
861: PUBLIC BOOL HTHost_killPipe (HTHost * host)
862: {
863: return killPipeline(host, HTEvent_CLOSE);
864: }
865:
866: /*
2.8 frystyk 867: ** Handle the connection mode. The mode may change mode in the
868: ** middle of a connection.
869: */
870: PUBLIC HTTransportMode HTHost_mode (HTHost * host, BOOL * active)
871: {
872: return host ? host->mode : HT_TP_SINGLE;
873: }
874:
875: /*
876: ** If the new mode is lower than the old mode then adjust the pipeline
877: ** accordingly. That is, if we are going into single mode then move
878: ** all entries in the pipeline and move the rest to the pending
879: ** queue. They will get launched at a later point in time.
880: */
881: PUBLIC BOOL HTHost_setMode (HTHost * host, HTTransportMode mode)
882: {
883: if (host) {
884: /*
885: ** Check the new mode and see if we must adjust the queues.
886: */
887: if (mode == HT_TP_SINGLE && host->mode > mode) {
888: int piped = HTList_count(host->pipeline);
889: if (piped > 0) {
890: int cnt;
2.59 frystyk 891: HTTRACE(CORE_TRACE, "Host info... Moving %d Net objects from pipe line to pending queue\n" _ piped);
2.8 frystyk 892: if (!host->pending) host->pending = HTList_new();
893: for (cnt=0; cnt<piped; cnt++) {
2.18 eric 894: HTNet * net = HTList_removeLastObject(host->pipeline);
2.59 frystyk 895: HTTRACE(CORE_TRACE, "Host info... Resetting net object %p\n" _ net);
2.13 frystyk 896: (*net->event.cbf)(HTChannel_socket(host->channel), net->event.param, HTEvent_RESET);
2.8 frystyk 897: HTList_appendObject(host->pending, net);
898: }
2.18 eric 899: HTChannel_setSemaphore(host->channel, 0);
900: HTHost_clearChannel(host, HT_INTERRUPTED);
2.8 frystyk 901: }
2.24 frystyk 902: }
903:
904: /*
905: ** If we know that this host is bad then we don't allow anything than
906: ** single mode. We can't recover connections for the rest of our life
907: */
908: if (mode == HT_TP_PIPELINE && host->recovered > MAX_HOST_RECOVER) {
2.59 frystyk 909: HTTRACE(PROT_TRACE, "Host info... %p is bad for pipelining so we won't do it!!!\n" _
2.24 frystyk 910: host);
911: } else {
912: host->mode = mode;
2.59 frystyk 913: HTTRACE(PROT_TRACE, "Host info... New mode is %d for host %p\n" _ host->mode _ host);
2.24 frystyk 914: }
2.8 frystyk 915: }
916: return NO;
917: }
918:
919: /*
920: ** Check whether a host is idle meaning if it is ready for a new
921: ** request which depends on the mode of the host. If the host is
922: ** idle, i.e. ready for use then return YES else NO. If the host supports
923: ** persistent connections then still only return idle if no requests are
924: ** ongoing.
925: */
926: PUBLIC BOOL HTHost_isIdle (HTHost * host)
927: {
2.32 frystyk 928: return (host && HTList_isEmpty(host->pipeline));
2.8 frystyk 929: }
930:
2.13 frystyk 931: PRIVATE BOOL _roomInPipe (HTHost * host)
932: {
933: int count;
2.34 frystyk 934: if (!host ||
935: (host->reqsPerConnection && host->reqsMade >= host->reqsPerConnection) ||
2.45 frystyk 936: HTHost_closeNotification(host) || host->broken_pipe)
2.32 frystyk 937: return NO;
2.13 frystyk 938: count = HTList_count(host->pipeline);
939: switch (host->mode) {
940: case HT_TP_SINGLE:
941: return count <= 0;
942: case HT_TP_PIPELINE:
2.51 frystyk 943: return (host->recovered < MAX_HOST_RECOVER) ?
944: (count < MaxPipelinedRequests) : (count <= 0);
2.13 frystyk 945: case HT_TP_INTERLEAVE:
946: return YES;
947: }
948: return NO;
949: }
950:
2.8 frystyk 951: /*
952: ** Add a net object to the host object. If the host
953: ** is idle then add to active list (pipeline) else add
954: ** it to the pending list
955: ** Return HT_PENDING if we must pend, HT_OK, or HT_ERROR
956: */
957: PUBLIC int HTHost_addNet (HTHost * host, HTNet * net)
958: {
959: if (host && net) {
960: int status = HT_OK;
2.32 frystyk 961: BOOL doit = (host->doit==net);
2.8 frystyk 962:
2.18 eric 963: /*
964: ** If we don't have a socket already then check to see if we can get
965: ** one. Otherwise we put the host object into our pending queue.
2.52 frystyk 966: */
2.18 eric 967: if (!host->channel && HTNet_availableSockets() <= 0) {
2.56 frystyk 968:
969: /* Create list for pending Host objects */
2.8 frystyk 970: if (!PendHost) PendHost = HTList_new();
2.56 frystyk 971:
972: /* Add the host object ad pending if not already */
973: if (HTList_indexOf(PendHost, host) < 0) HTList_addObject(PendHost, host);
974:
975: /*
976: ** Add the Net object to the Host object. If it is the current Net
977: ** obejct holding the lock then add it to the beginning of the list.
978: ** Otherwise add it to the end
979: */
2.52 frystyk 980: if (!host->pending) host->pending = HTList_new();
2.56 frystyk 981: if (host->lock == net)
982: HTList_appendObject(host->pending, net);
983: else
984: HTList_addObject(host->pending, net);
985:
2.59 frystyk 986: HTTRACE(CORE_TRACE, "Host info... Added Net %p (request %p) as pending on pending Host %p, %d requests made, %d requests in pipe, %d pending\n" _
987: net _ net->request _ host _ host->reqsMade _
988: HTList_count(host->pipeline) _ HTList_count(host->pending));
2.52 frystyk 989: return HT_PENDING;
2.8 frystyk 990: }
991:
2.45 frystyk 992: #if 0
2.18 eric 993: /*
2.45 frystyk 994: ** First check whether the net object is already on either queue.
995: ** Do NOT add extra copies of the HTNet object to
996: ** the pipeline or pending list (if it's already on the list).
997: */
998: if (HTList_indexOf(host->pipeline, net) >= 0) {
2.59 frystyk 999: HTTRACE(CORE_TRACE, "Host info... The Net %p (request %p) is already in pipe,"
1000: " %d requests made, %d requests in pipe, %d pending\n" _
1001: net _ net->request _ host->reqsMade _
1002: HTList_count(host->pipeline) _
2.45 frystyk 1003: HTList_count(host->pending));
2.59 frystyk 1004: HTDEBUGBREAK("Net object %p registered multiple times in pipeline\n" _
2.45 frystyk 1005: net);
1006: return HT_OK;
1007: }
2.44 frystyk 1008:
2.45 frystyk 1009: if (HTList_indexOf(host->pending, net) >= 0) {
2.59 frystyk 1010: HTTRACE(CORE_TRACE, "Host info... The Net %p (request %p) already pending,"
1011: " %d requests made, %d requests in pipe, %d pending\n" _
1012: net _ net->request _ host->reqsMade _
1013: HTList_count(host->pipeline) _
2.45 frystyk 1014: HTList_count(host->pending));
2.59 frystyk 1015: HTDEBUGBREAK("Net object %p registered multiple times in pending queue\n" _
2.45 frystyk 1016: net);
1017:
1018: return HT_PENDING;
1019: }
1020: #endif
2.44 frystyk 1021:
1022: /*
2.18 eric 1023: ** Add net object to either active or pending queue.
1024: */
2.44 frystyk 1025: if (_roomInPipe(host) && (HTList_isEmpty(host->pending) || doit)) {
2.32 frystyk 1026: if (doit) host->doit = NULL;
2.8 frystyk 1027: if (!host->pipeline) host->pipeline = HTList_new();
1028: HTList_addObject(host->pipeline, net);
2.32 frystyk 1029: host->reqsMade++;
2.59 frystyk 1030: HTTRACE(CORE_TRACE, "Host info... Added Net %p (request %p) to pipe on Host %p, %d requests made, %d requests in pipe, %d pending\n" _
1031: net _ net->request _ host _ host->reqsMade _
1032: HTList_count(host->pipeline) _ HTList_count(host->pending));
2.18 eric 1033:
2.13 frystyk 1034: /*
2.30 frystyk 1035: ** If we have been idle then make sure we delete the timer
2.13 frystyk 1036: */
2.30 frystyk 1037: if (host->timer) {
1038: HTTimer_delete(host->timer);
1039: host->timer = NULL;
1040: }
2.40 kahan 1041:
1042: /*JK: New CBF function
1043: ** Call any user-defined callback to say the request will
1044: ** be processed.
1045: */
1046: HTHost_ActivateRequest (net);
2.30 frystyk 1047:
2.8 frystyk 1048: } else {
1049: if (!host->pending) host->pending = HTList_new();
2.44 frystyk 1050: HTList_addObject(host->pending, net);
2.59 frystyk 1051: HTTRACE(CORE_TRACE, "Host info... Added Net %p (request %p) as pending on Host %p, %d requests made, %d requests in pipe, %d pending\n" _
1052: net _ net->request _
1053: host _ host->reqsMade _
1054: HTList_count(host->pipeline) _ HTList_count(host->pending));
2.8 frystyk 1055: status = HT_PENDING;
1056: }
1057: return status;
1058: }
1059: return HT_ERROR;
1060: }
1061:
2.51 frystyk 1062: PRIVATE BOOL HTHost_free (HTHost * host, int status)
2.13 frystyk 1063: {
2.32 frystyk 1064: if (host->channel) {
2.13 frystyk 1065:
2.32 frystyk 1066: /* Check if we should keep the socket open */
1067: if (HTHost_isPersistent(host)) {
2.48 frystyk 1068: int piped = HTList_count(host->pipeline);
2.37 frystyk 1069: if (HTHost_closeNotification(host)) {
2.59 frystyk 1070: HTTRACE(CORE_TRACE, "Host Object. got close notifiation on socket %d\n" _
2.37 frystyk 1071: HTChannel_socket(host->channel));
1072:
1073: /*
1074: ** If more than a single element (this one) in the pipe
1075: ** then we have to recover gracefully
1076: */
1077: if (piped > 1) {
1078: host->reqsPerConnection = host->reqsMade - piped;
2.59 frystyk 1079: HTTRACE(CORE_TRACE, "%d requests made, %d in pipe, max %d requests pr connection\n" _
1080: host->reqsMade _ piped _ host->reqsPerConnection);
2.37 frystyk 1081: host->do_recover = YES;
2.38 frystyk 1082: HTChannel_delete(host->channel, status);
2.62 frystyk 1083: host->channel = NULL;
2.38 frystyk 1084: } else {
1085: HTChannel_setSemaphore(host->channel, 0);
1086: HTHost_clearChannel(host, status);
2.37 frystyk 1087: }
2.48 frystyk 1088: } else if (piped<=1 && host->reqsMade==host->reqsPerConnection) {
2.59 frystyk 1089: HTTRACE(CORE_TRACE, "Host Object. closing persistent socket %d\n" _
2.37 frystyk 1090: HTChannel_socket(host->channel));
2.32 frystyk 1091:
1092: /*
1093: ** By lowering the semaphore we make sure that the channel
1094: ** is gonna be deleted
1095: */
1096: HTChannel_setSemaphore(host->channel, 0);
1097: HTHost_clearChannel(host, status);
1098:
1099: } else {
2.59 frystyk 1100: HTTRACE(CORE_TRACE, "Host Object. keeping persistent socket %d\n" _
2.56 frystyk 1101: HTChannel_socket(host->channel));
2.62 frystyk 1102: if (HTChannel_delete(host->channel, status)) {
2.59 frystyk 1103: HTDEBUGBREAK("Host Event.. Channel unexpected deleted from host %p (%s)\n" _ host _ host->hostname);
2.62 frystyk 1104: host->channel = NULL;
1105: }
2.32 frystyk 1106: /*
1107: ** If connection is idle then set a timer so that we close the
1108: ** connection if idle too long
1109: */
2.48 frystyk 1110: if (piped<=1 && HTList_isEmpty(host->pending) && !host->timer) {
1111: host->timer = HTTimer_new(NULL, IdleTimeoutEvent,
2.53 frystyk 1112: host, HTActiveTimeout, YES, NO);
2.59 frystyk 1113: HTTRACE(PROT_TRACE, "Host........ Object %p going idle...\n" _ host);
2.32 frystyk 1114: }
1115: }
1116: return YES;
1117: } else {
2.59 frystyk 1118: HTTRACE(CORE_TRACE, "Host Object. closing socket %d\n" _ HTChannel_socket(host->channel));
2.47 frystyk 1119: HTChannel_setSemaphore(host->channel, 0);
2.41 frystyk 1120: HTHost_clearChannel(host, status);
2.32 frystyk 1121: }
2.13 frystyk 1122: }
2.32 frystyk 1123: return NO;
2.13 frystyk 1124: }
1125:
2.51 frystyk 1126: PUBLIC BOOL HTHost_deleteNet (HTHost * host, HTNet * net, int status)
2.8 frystyk 1127: {
1128: if (host && net) {
2.59 frystyk 1129: HTTRACE(CORE_TRACE, "Host info... Remove %p from pipe\n" _ net);
2.51 frystyk 1130:
1131: /* If the Net object is in the pipeline then also update the channel */
1132: if (host->pipeline && HTList_indexOf(host->pipeline, net) >= 0) {
1133: HTHost_free(host, status);
1134: HTList_removeObjectAll(host->pipeline, net);
1135: }
1136:
2.44 frystyk 1137: HTList_removeObjectAll(host->pending, net); /* just to make sure */
2.62 frystyk 1138: host->lock = HTList_firstObject(host->pending);
2.8 frystyk 1139: return YES;
1140: }
1141: return NO;
1142: }
1143:
1144: /*
1145: ** Handle pending host objects.
1146: ** There are two ways we can end up with pending reqyests:
1147: ** 1) If we are out of sockets then register new host objects as pending.
1148: ** 2) If we are pending on a connection then register new net objects as
1149: ** pending
1150: ** This set of functions handles pending host objects and can start new
1151: ** requests as resources get available
1152: */
1153:
1154: /*
1155: ** Check this host object for any pending requests and return the next
1156: ** registered Net object.
1157: */
1158: PUBLIC HTNet * HTHost_nextPendingNet (HTHost * host)
1159: {
1160: HTNet * net = NULL;
2.32 frystyk 1161: if (host && host->pending) {
2.18 eric 1162: /*JK 23/Sep/96 Bug correction. Associated the following lines to the
1163: **above if. There was a missing pair of brackets.
1164: */
1165: if ((net = (HTNet *) HTList_removeFirstObject(host->pending)) != NULL) {
2.59 frystyk 1166: HTTRACE(CORE_TRACE, "Host info... Popping %p from pending net queue on host %p\n" _
1167: net _ host);
2.33 frystyk 1168: #if 0
1169: {
1170: HTRequest * request = HTNet_request(net);
1171: char * uri = HTAnchor_address((HTAnchor *) HTRequest_anchor(request));
1172: fprintf(stderr, "Popping '%s'\n", uri);
1173: }
1174: #endif
2.32 frystyk 1175: host->doit = net;
2.18 eric 1176: }
2.8 frystyk 1177: }
1178: return net;
1179: }
1180:
1181: /*
2.13 frystyk 1182: ** Return the current list of pending host objects waiting for a socket
2.8 frystyk 1183: */
1184: PUBLIC HTHost * HTHost_nextPendingHost (void)
1185: {
1186: HTHost * host = NULL;
1187: if (PendHost) {
1188: if ((host = (HTHost *) HTList_removeFirstObject(PendHost)) != NULL)
2.59 frystyk 1189: HTTRACE(PROT_TRACE, "Host info... Popping %p from pending host queue\n" _
2.8 frystyk 1190: host);
1191: }
1192: return host;
1193: }
1194:
1195: /*
1196: ** Start the next pending request if any. First we look for pending
1197: ** requests for the same host and then we check for any other pending
1198: ** hosts
1199: */
1200: PUBLIC BOOL HTHost_launchPending (HTHost * host)
1201: {
2.52 frystyk 1202: HTNet * net = NULL;
2.8 frystyk 1203: if (!host) {
2.59 frystyk 1204: HTTRACE(PROT_TRACE, "Host info... Bad arguments\n");
2.8 frystyk 1205: return NO;
1206: }
1207:
1208: /*
2.52 frystyk 1209: ** In pipeline we can only have one doing writing at a time.
1210: ** We therefore check that there are no other Net object
1211: ** registered for write
2.8 frystyk 1212: */
2.52 frystyk 1213: if (host->mode == HT_TP_PIPELINE) {
1214: net = (HTNet *) HTList_lastObject(host->pipeline);
1215: if (net && net->registeredFor == HTEvent_WRITE)
1216: return NO;
1217: }
2.8 frystyk 1218:
2.52 frystyk 1219: /*
1220: ** Check the current Host object for pending Net objects
1221: */
1222: if (_roomInPipe(host) && DoPendingReqLaunch &&
1223: (net = HTHost_nextPendingNet(host))) {
1224: HTHost_ActivateRequest(net);
2.59 frystyk 1225: HTTRACE(CORE_TRACE, "Launch pending net object %p with %d reqs in pipe (%d reqs made)\n" _
1226: net _ HTList_count(host->pipeline) _ host->reqsMade);
2.52 frystyk 1227: return HTNet_execute(net, HTEvent_WRITE);
1228: }
2.13 frystyk 1229:
2.52 frystyk 1230: /*
1231: ** Check for other pending Host objects
1232: */
1233: if (DoPendingReqLaunch && HTNet_availableSockets() > 0) {
1234: HTHost * pending = HTHost_nextPendingHost();
1235: if (pending && (net = HTHost_nextPendingNet(pending))) {
1236: if (!pending->pipeline) pending->pipeline = HTList_new();
1237: HTList_addObject(pending->pipeline, net);
1238: host->reqsMade++;
2.59 frystyk 1239: HTTRACE(CORE_TRACE, "Launch pending host object %p, net %p with %d reqs in pipe (%d reqs made)\n" _
1240: pending _ net _ HTList_count(pending->pipeline) _ pending->reqsMade);
2.52 frystyk 1241: HTHost_ActivateRequest(net);
1242: return HTNet_execute(net, HTEvent_WRITE);
2.8 frystyk 1243: }
2.52 frystyk 1244: }
1245: return YES;
2.13 frystyk 1246: }
1247:
1248: PUBLIC HTNet * HTHost_firstNet (HTHost * host)
1249: {
1250: return (HTNet *) HTList_firstObject(host->pipeline);
2.60 frystyk 1251: }
1252:
1253: PUBLIC int HTHost_numberOfOutstandingNetObjects (HTHost * host)
1254: {
1255: return host ? HTList_count(host->pipeline) : -1;
1256: }
1257:
1258: PUBLIC int HTHost_numberOfPendingNetObjects (HTHost * host)
1259: {
1260: return host ? HTList_count(host->pending) : -1;
2.13 frystyk 1261: }
1262:
1263: /*
1264: ** The host event manager keeps track of the state of it's client engines
1265: ** (typically HTTPEvent), accepting multiple blocks on read or write from
1266: ** multiple pipelined engines. It then registers its own engine
1267: ** (HostEvent) with the event manager.
1268: */
1269: PUBLIC int HTHost_connect (HTHost * host, HTNet * net, char * url, HTProtocolId port)
1270: {
2.42 frystyk 1271: HTRequest * request = HTNet_request(net);
2.52 frystyk 1272: int status = HT_OK;
2.42 frystyk 1273: if (!host) {
1274: HTProtocol * protocol = HTNet_protocol(net);
1275: if ((host = HTHost_newWParse(request, url, HTProtocol_id(protocol))) == NULL)
2.45 frystyk 1276: return HT_ERROR;
2.52 frystyk 1277:
1278: /*
1279: ** If not already locked and without a channel
2.55 frystyk 1280: ** then lock the darn thing with the first Net object
1281: ** pending.
2.52 frystyk 1282: */
1283: if (!host->lock && !host->channel) {
2.55 frystyk 1284: HTNet * next_pending = NULL;
2.42 frystyk 1285: host->forceWriteFlush = YES;
2.55 frystyk 1286: host->lock = (next_pending = HTList_firstObject(host->pending)) ?
1287: next_pending : net;
2.59 frystyk 1288: HTTRACE(CORE_TRACE, "Host connect Grabbing lock on Host %p with %p\n" _ host _ host->lock);
2.42 frystyk 1289: }
1290: HTNet_setHost(net, host);
1291: }
1292:
1293: if (!host->lock || (host->lock && host->lock == net)) {
1294: status = HTDoConnect(net, url, port);
2.55 frystyk 1295: if (status == HT_PENDING)
1296: return HT_WOULD_BLOCK;
1297: else if (status == HT_WOULD_BLOCK) {
2.42 frystyk 1298: host->lock = net;
2.52 frystyk 1299: return status;
2.55 frystyk 1300: } else {
1301:
1302: /*
1303: ** See if there is already a new pending request that should
1304: ** take over the current lock
1305: */
1306: HTNet * next_pending = NULL;
1307: if ((next_pending = HTList_firstObject(host->pending))) {
2.59 frystyk 1308: HTTRACE(CORE_TRACE, "Host connect Changing lock on Host %p to %p\n" _
1309: host _ next_pending);
2.55 frystyk 1310: host->lock = next_pending;
1311: } else {
2.59 frystyk 1312: HTTRACE(CORE_TRACE, "Host connect Unlocking Host %p\n" _ host);
2.55 frystyk 1313: host->lock = NULL;
1314: }
1315: return status;
2.42 frystyk 1316: }
1317: } else {
2.59 frystyk 1318: HTTRACE(CORE_TRACE, "Host connect Host %p already locked with %p\n" _ host _ host->lock);
2.42 frystyk 1319: if ((status = HTHost_addNet(host, net)) == HT_PENDING) {
1320: return HT_PENDING;
1321: }
2.54 frystyk 1322: }
1323: return HT_ERROR; /* @@@ - some more deletion and stuff here? */
1324: }
1325:
1326: PUBLIC int HTHost_accept (HTHost * host, HTNet * net, HTNet ** accepted,
1327: char * url, HTProtocolId port)
1328: {
1329: HTRequest * request = HTNet_request(net);
1330: int status = HT_OK;
1331: if (!host) {
1332: HTProtocol * protocol = HTNet_protocol(net);
1333: if ((host = HTHost_newWParse(request, url, HTProtocol_id(protocol))) == NULL)
1334: return HT_ERROR;
1335: else {
1336: SockA *sin = &host->sock_addr;
1337: sin->sin_addr.s_addr = INADDR_ANY;
1338: }
1339:
1340: /*
1341: ** If not already locked and without a channel
1342: ** then lock the darn thing
1343: */
1344: if (!host->lock && !host->channel) {
1345: host->forceWriteFlush = YES;
1346: host->lock = net;
1347: }
1348: HTNet_setHost(net, host);
1349:
1350: /*
1351: ** Start listening on the socket
1352: */
1353: {
1354: status = HTDoListen(net, port, INVSOC, HT_BACKLOG);
1355: if (status != HT_OK) {
2.59 frystyk 1356: HTTRACE(CORE_TRACE, "Listen...... On Host %p resulted in %d\n" _ host _ status);
2.54 frystyk 1357: return HT_ERROR;
1358: }
1359: }
1360: }
1361:
1362: if (!host->lock || (host->lock && host->lock == net)) {
1363: status = HTDoAccept(net, accepted);
1364: if (status == HT_OK) {
1365:
1366: /* Add the new accepted Net object to the pipeline */
1367: HTList_appendObject(host->pipeline, *accepted);
1368:
1369: /* Unlock the accept object */
1370: host->lock = NULL;
1371:
1372: return HT_OK;
1373: }
1374: if (status == HT_WOULD_BLOCK) {
1375: host->lock = net;
1376: return status;
1377: }
1378: if (status == HT_PENDING) return HT_WOULD_BLOCK;
2.42 frystyk 1379: }
2.13 frystyk 1380: return HT_ERROR; /* @@@ - some more deletion and stuff here? */
1381: }
1382:
1383: /*
1384: ** Rules: SINGLE: one element in pipe, either reading or writing
1385: ** PIPE: n element in pipe, n-1 reading, 1 writing
1386: */
1387: PUBLIC int HTHost_register (HTHost * host, HTNet * net, HTEventType type)
1388: {
2.40 kahan 1389: HTEvent *event;
1390:
2.13 frystyk 1391: if (host && net) {
1392:
2.28 frystyk 1393: if (type == HTEvent_CLOSE) {
2.13 frystyk 1394:
2.28 frystyk 1395: /*
1396: ** Unregister this host for all events
1397: */
1398: HTEvent_unregister(HTChannel_socket(host->channel), HTEvent_READ);
1399: HTEvent_unregister(HTChannel_socket(host->channel), HTEvent_WRITE);
1400: host->registeredFor = 0;
2.13 frystyk 1401: return YES;
2.28 frystyk 1402:
1403: } else {
1404:
1405: /* net object may already be registered */
1406: if (HTEvent_BITS(type) & net->registeredFor)
1407: return NO;
1408: net->registeredFor ^= HTEvent_BITS(type);
1409:
1410: /* host object may already be registered */
1411: if (host->registeredFor & HTEvent_BITS(type))
1412: return YES;
1413: host->registeredFor ^= HTEvent_BITS(type);
2.46 frystyk 1414:
1415: #ifdef WWW_WIN_ASYNC
1416: /* Make sure we are registered for CLOSE on windows */
1417: event = *(host->events+HTEvent_INDEX(HTEvent_CLOSE));
1418: HTEvent_register(HTChannel_socket(host->channel), HTEvent_CLOSE, event);
1419: #endif /* WWW_WIN_ASYNC */
1420:
1421: /* JK: register a request in the event structure */
2.40 kahan 1422: event = *(host->events+HTEvent_INDEX(type));
1423: event->request = HTNet_request (net);
2.28 frystyk 1424: return HTEvent_register(HTChannel_socket(host->channel),
2.40 kahan 1425: type, event);
2.28 frystyk 1426: }
2.52 frystyk 1427:
1428: return YES;
2.13 frystyk 1429: }
2.52 frystyk 1430: if ("HTHost req.. Bad arguments\n");
2.13 frystyk 1431: return NO;
1432: }
1433:
1434: PUBLIC int HTHost_unregister (HTHost * host, HTNet * net, HTEventType type)
1435: {
1436: if (host && net) {
1437:
2.28 frystyk 1438: /* net object may not be registered */
2.13 frystyk 1439: if (!(HTEvent_BITS(type) & net->registeredFor))
1440: return NO;
1441: net->registeredFor ^= HTEvent_BITS(type);
1442:
2.28 frystyk 1443: /* host object may not be registered */
2.13 frystyk 1444: if (!(host->registeredFor & HTEvent_BITS(type)))
1445: return YES;
1446: host->registeredFor ^= HTEvent_BITS(type);
1447:
1448: /* stay registered for READ to catch a socket close */
1449: /* WRITE and CONNECT can be unregistered, though */
1450: if ((type == HTEvent_WRITE && isLastInPipe(host, net)) ||
1451: type == HTEvent_CONNECT)
1452: /* if we are blocked downstream, shut down the whole pipe */
1453: HTEvent_unregister(HTChannel_socket(host->channel), type);
1454: return YES;
1455: }
1456: return NO;
1457: }
1458:
1459: /*
1460: ** The reader tells HostEvent that it's stream did not finish the data
1461: */
1462: PUBLIC BOOL HTHost_setRemainingRead (HTHost * host, size_t remaining)
1463: {
1464: if (host == NULL) return NO;
1465: host->remainingRead = remaining;
2.59 frystyk 1466: HTTRACE(PROT_TRACE, "Host........ %d bytes remaining \n" _ remaining);
2.45 frystyk 1467: if (host->broken_pipe && remaining == 0) {
2.59 frystyk 1468: HTTRACE(PROT_TRACE, "Host........ Emtied out connection\n");
2.45 frystyk 1469: }
2.13 frystyk 1470: return YES;
1471: }
1472:
2.32 frystyk 1473: PUBLIC size_t HTHost_remainingRead (HTHost * host)
1474: {
1475: return host ? host->remainingRead : -1;
1476: }
1477:
2.13 frystyk 1478: PUBLIC SockA * HTHost_getSockAddr (HTHost * host)
1479: {
1480: if (!host) return NULL;
1481: return &host->sock_addr;
1482: }
1483:
1484: PUBLIC BOOL HTHost_setHome (HTHost * host, int home)
1485: {
1486: if (!host) return NO;
1487: host->home = home;
1488: return YES;
1489: }
1490:
1491: PUBLIC int HTHost_home (HTHost * host)
1492: {
1493: if (!host) return 0;
1494: return host->home;
1495: }
1496:
2.27 frystyk 1497: PUBLIC BOOL HTHost_setRetry (HTHost * host, int retry)
1498: {
1499: if (!host) return NO;
1500: host->retry = retry;
1501: return YES;
1502: }
1503:
1504: PUBLIC BOOL HTHost_decreaseRetry (HTHost * host)
1505: {
2.44 frystyk 1506: if (!host) return NO;
1507:
1508: if (host->retry > 0) host->retry--;
1509: return YES;
1510:
2.27 frystyk 1511: }
1512:
1513: PUBLIC int HTHost_retry (HTHost * host)
1514: {
1515: if (!host) return 0;
1516: return host->retry;
1517: }
1518:
2.13 frystyk 1519: #if 0 /* Is a macro right now */
2.21 frystyk 1520: PRIVATE BOOL HTHost_setDNS5 (HTHost * host, HTdns * dns)
2.13 frystyk 1521: {
1522: if (!host) return NO;
1523: host->dns = dns;
1524: return YES;
1525: }
1526: #endif
1527:
1528: PUBLIC BOOL HTHost_setChannel (HTHost * host, HTChannel * channel)
1529: {
1530: if (!host) return NO;
1531: host->channel = channel;
1532: return YES;
1533: }
1534:
1535: PUBLIC HTNet * HTHost_getReadNet(HTHost * host)
1536: {
2.38 frystyk 1537: return host ? (HTNet *) HTList_firstObject(host->pipeline) : NULL;
2.13 frystyk 1538: }
1539:
1540: PUBLIC HTNet * HTHost_getWriteNet(HTHost * host)
1541: {
1542: return host ? (HTNet *) HTList_lastObject(host->pipeline) : NULL;
1543: }
1544:
1545: /*
1546: ** Create the input stream and bind it to the channel
1547: ** Please read the description in the HTIOStream module for the parameters
1548: */
1549: PUBLIC HTInputStream * HTHost_getInput (HTHost * host, HTTransport * tp,
1550: void * param, int mode)
1551: {
1552: if (host && host->channel && tp) {
1553: HTChannel * ch = host->channel;
1554: HTInputStream * input = (*tp->input_new)(host, ch, param, mode);
1555: HTChannel_setInput(ch, input);
1556: return HTChannel_getChannelIStream(ch);
1557: }
2.59 frystyk 1558: HTTRACE(CORE_TRACE, "Host Object. Can't create input stream\n");
2.13 frystyk 1559: return NULL;
1560: }
1561:
1562: PUBLIC HTOutputStream * HTHost_getOutput (HTHost * host, HTTransport * tp,
1563: void * param, int mode)
1564: {
1565: if (host && host->channel && tp) {
1566: HTChannel * ch = host->channel;
1567: HTOutputStream * output = (*tp->output_new)(host, ch, param, mode);
1568: HTChannel_setOutput(ch, output);
1569: return output;
1570: }
2.59 frystyk 1571: HTTRACE(CORE_TRACE, "Host Object. Can't create output stream\n");
2.13 frystyk 1572: return NULL;
1573: }
1574:
1575: PUBLIC HTOutputStream * HTHost_output (HTHost * host, HTNet * net)
1576: {
1577: if (host && host->channel && net) {
1578: HTOutputStream * output = HTChannel_output(host->channel);
1579: return output;
1580: }
1581: return NULL;
1582: }
1583:
1584: PUBLIC int HTHost_read(HTHost * host, HTNet * net)
1585: {
1586: HTInputStream * input = HTChannel_input(host->channel);
1587: if (net != HTHost_getReadNet(host)) {
1588: HTHost_register(host, net, HTEvent_READ);
1589: return HT_WOULD_BLOCK;
1590: }
2.17 frystyk 1591:
1592: /*
1593: ** If there is no input channel then this can either mean that
1594: ** we have lost the channel or an error occurred. We return
1595: ** HT_CLOSED as this is a sign to the caller that we don't
1596: ** have a channel
1597: */
1598: return input ? (*input->isa->read)(input) : HT_CLOSED;
2.13 frystyk 1599: }
1600:
1601: PUBLIC BOOL HTHost_setConsumed(HTHost * host, size_t bytes)
1602: {
1603: HTInputStream * input;
1604: if (!host || !host->channel) return NO;
1605: if ((input = HTChannel_input(host->channel)) == NULL)
1606: return NO;
2.59 frystyk 1607: HTTRACE(CORE_TRACE, "Host........ passing %d bytes as consumed to %p\n" _ bytes _ input);
2.13 frystyk 1608: return (*input->isa->consumed)(input, bytes);
1609: }
1610:
1611: PUBLIC int HTHost_hash (HTHost * host)
1612: {
1613: return host ? host->hash : -1;
1614: }
1615:
2.26 frystyk 1616: PUBLIC BOOL HTHost_setWriteDelay (HTHost * host, ms_t delay)
2.13 frystyk 1617: {
2.26 frystyk 1618: if (host && delay >= 0) {
1619: host->delay = delay;
1620: return YES;
1621: }
1622: return NO;
1623: }
1624:
1625: PUBLIC ms_t HTHost_writeDelay (HTHost * host)
1626: {
1627: return host ? host->delay : 0;
1628: }
1629:
1630: PUBLIC int HTHost_findWriteDelay (HTHost * host, ms_t lastFlushTime, int buffSize)
1631: {
2.35 frystyk 1632: #if 0
2.15 eric 1633: unsigned short mtu;
2.18 eric 1634: int ret = -1;
2.15 eric 1635: int socket = HTChannel_socket(host->channel);
2.18 eric 1636: #ifndef WWW_MSWINDOWS
2.15 eric 1637: ret = ioctl(socket, 666, (unsigned long)&mtu);
2.18 eric 1638: #endif /* WWW_MSWINDOWS */
2.15 eric 1639: if ((ret == 0 && buffSize >= mtu) || host->forceWriteFlush)
2.13 frystyk 1640: return 0;
2.26 frystyk 1641: return host->delay;
2.35 frystyk 1642: #else
1643: return host->forceWriteFlush ? 0 : host->delay;
1644: #endif
2.13 frystyk 1645: }
1646:
2.26 frystyk 1647: PUBLIC BOOL HTHost_setDefaultWriteDelay (ms_t delay)
1648: {
1649: if (delay >= 0) {
1650: WriteDelay = delay;
2.59 frystyk 1651: HTTRACE(CORE_TRACE, "Host........ Default write delay is %d ms\n" _ delay);
2.26 frystyk 1652: return YES;
1653: }
1654: return NO;
1655: }
1656:
1657: PUBLIC ms_t HTHost_defaultWriteDelay (void)
1658: {
1659: return WriteDelay;
1660: }
1661:
2.13 frystyk 1662: PUBLIC int HTHost_forceFlush(HTHost * host)
1663: {
2.35 frystyk 1664: HTNet * targetNet = (HTNet *) HTList_lastObject(host->pipeline);
2.13 frystyk 1665: int ret;
2.35 frystyk 1666: if (targetNet == NULL) return HT_ERROR;
2.59 frystyk 1667: HTTRACE(CORE_TRACE, "Host Event.. FLUSH passed to `%s\'\n" _
2.28 frystyk 1668: HTAnchor_physical(HTRequest_anchor(HTNet_request(targetNet))));
2.13 frystyk 1669: host->forceWriteFlush = YES;
1670: ret = (*targetNet->event.cbf)(HTChannel_socket(host->channel), targetNet->event.param, HTEvent_FLUSH);
2.35 frystyk 1671: host->forceWriteFlush = NO;
2.13 frystyk 1672: return ret;
2.39 frystyk 1673: }
1674:
1675: /*
1676: ** Context pointer to be used as a user defined context
1677: */
1678: PUBLIC void HTHost_setContext (HTHost * me, void * context)
1679: {
2.40 kahan 1680: if (me) me->context = context;
2.39 frystyk 1681: }
1682:
1683: PUBLIC void * HTHost_context (HTHost * me)
1684: {
2.40 kahan 1685: return me ? me->context : NULL;
2.1 frystyk 1686: }
2.11 kahan 1687:
2.13 frystyk 1688: PUBLIC int HTHost_eventTimeout (void)
1689: {
1690: return EventTimeout;
1691: }
2.11 kahan 1692:
2.13 frystyk 1693: PUBLIC void HTHost_setEventTimeout (int millis)
1694: {
1695: EventTimeout = millis;
2.59 frystyk 1696: HTTRACE(CORE_TRACE, "Host........ Setting event timeout to %d ms\n" _ millis);
2.13 frystyk 1697: }
2.40 kahan 1698:
2.45 frystyk 1699: PUBLIC BOOL HTHost_setMaxPipelinedRequests (int max)
1700: {
1701: if (max > 1) {
1702: MaxPipelinedRequests = max;
1703: return YES;
1704: }
1705: return NO;
1706: }
2.40 kahan 1707:
2.45 frystyk 1708: PUBLIC int HTHost_maxPipelinedRequests (void)
2.40 kahan 1709: {
2.45 frystyk 1710: return MaxPipelinedRequests;
1711: }
1712:
1713: PUBLIC void HTHost_setActivateRequestCallback (HTHost_ActivateRequestCallback * cbf)
1714: {
2.59 frystyk 1715: HTTRACE(CORE_TRACE, "HTHost...... Registering %p\n" _ cbf);
2.40 kahan 1716: ActivateReqCBF = cbf;
1717: }
1718:
2.45 frystyk 1719: PRIVATE int HTHost_ActivateRequest (HTNet * net)
2.40 kahan 1720: {
2.45 frystyk 1721: HTRequest * request = NULL;
1722: if (!ActivateReqCBF) {
2.59 frystyk 1723: HTTRACE(CORE_TRACE, "HTHost...... No ActivateRequest callback handler registered\n");
2.45 frystyk 1724: return HT_ERROR;
1725: }
1726: request = HTNet_request(net);
1727: return (*ActivateReqCBF)(request);
2.40 kahan 1728: }
1729:
1730: PUBLIC void HTHost_disable_PendingReqLaunch (void)
1731: {
2.45 frystyk 1732: DoPendingReqLaunch = NO;
2.40 kahan 1733: }
1734:
1735: PUBLIC void HTHost_enable_PendingReqLaunch (void)
1736: {
2.45 frystyk 1737: DoPendingReqLaunch = YES;
2.40 kahan 1738: }
1739:
Webmaster