1/* 2 * Copyright (c) 2009-2010 Apple Inc. All Rights Reserved. 3 * 4 * @APPLE_LICENSE_HEADER_START@ 5 * 6 * This file contains Original Code and/or Modifications of Original Code 7 * as defined in and that are subject to the Apple Public Source License 8 * Version 2.0 (the 'License'). You may not use this file except in 9 * compliance with the License. Please obtain a copy of the License at 10 * http://www.opensource.apple.com/apsl/ and read it before using this 11 * file. 12 * 13 * The Original Code and all software distributed under the License are 14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, 16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, 17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 18 * Please see the License for the specific language governing rights and 19 * limitations under the License. 20 * 21 * @APPLE_LICENSE_HEADER_END@ 22 */ 23 24/*! 25 @header asynchttp 26 The functions provided in asynchttp.h provide an interface to 27 an asynchronous http get/post engine. 28*/ 29 30#ifndef _SECURITYD_ASYNCHTTP_H_ 31#define _SECURITYD_ASYNCHTTP_H_ 32 33#include <stdbool.h> 34#include <CoreFoundation/CFData.h> 35#include <CoreFoundation/CFURL.h> 36#include <CoreFoundation/CFDate.h> 37#include <CFNetwork/CFHTTPMessage.h> 38#include <CFNetwork/CFHTTPStream.h> 39#include <dispatch/dispatch.h> 40 41__BEGIN_DECLS 42 43typedef struct asynchttp_s { 44 void(*completed)(struct asynchttp_s *http, CFTimeInterval maxAge); 45 void *info; 46 CFHTTPMessageRef request; 47 CFHTTPMessageRef response; 48 dispatch_queue_t queue; 49 /* The fields below should be considered private. */ 50 CFMutableDataRef data; 51 CFReadStreamRef stream; 52 dispatch_source_t timer; 53} asynchttp_t; 54 55/* Return false if work was scheduled and the callback will be invoked, 56 true if it wasn't or the callback was already called. */ 57bool asyncHttpPost(CFURLRef cfUrl, CFDataRef postData, asynchttp_t *http); 58 59/* Caller owns struct pointed to by http, but is responsible for calling 60 asynchttp_free() when it's done with it. */ 61bool asynchttp_request(CFHTTPMessageRef request, asynchttp_t *http); 62void asynchttp_free(asynchttp_t *http); 63 64/* */ 65 66 67__END_DECLS 68 69#endif /* !_SECURITYD_ASYNCHTTP_H_ */ 70