2000-05-22 10:12:12 -04:00
|
|
|
#ifndef __CURL_CURL_H
|
|
|
|
#define __CURL_CURL_H
|
1999-12-29 09:20:26 -05:00
|
|
|
/*****************************************************************************
|
|
|
|
* _ _ ____ _
|
|
|
|
* Project ___| | | | _ \| |
|
|
|
|
* / __| | | | |_) | |
|
|
|
|
* | (__| |_| | _ <| |___
|
|
|
|
* \___|\___/|_| \_\_____|
|
|
|
|
*
|
2001-01-03 04:29:33 -05:00
|
|
|
* Copyright (C) 2000, Daniel Stenberg, <daniel@haxx.se>, et al.
|
1999-12-29 09:20:26 -05:00
|
|
|
*
|
2001-01-03 04:29:33 -05:00
|
|
|
* In order to be useful for every potential user, curl and libcurl are
|
|
|
|
* dual-licensed under the MPL and the MIT/X-derivate licenses.
|
1999-12-29 09:20:26 -05:00
|
|
|
*
|
2001-01-03 04:29:33 -05:00
|
|
|
* You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
|
|
|
* copies of the Software, and permit persons to whom the Software is
|
|
|
|
* furnished to do so, under the terms of the MPL or the MIT/X-derivate
|
|
|
|
* licenses. You may pick one of these licenses.
|
1999-12-29 09:20:26 -05:00
|
|
|
*
|
2001-01-03 04:29:33 -05:00
|
|
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
|
|
|
* KIND, either express or implied.
|
1999-12-29 09:20:26 -05:00
|
|
|
*
|
2001-01-03 04:29:33 -05:00
|
|
|
* $Id$
|
|
|
|
*****************************************************************************/
|
2000-05-22 10:12:12 -04:00
|
|
|
|
2000-12-14 03:34:47 -05:00
|
|
|
#include <stdio.h>
|
2000-05-22 10:12:12 -04:00
|
|
|
/* The include stuff here is mainly for time_t! */
|
|
|
|
#ifdef vms
|
|
|
|
# include <types.h>
|
|
|
|
# include <time.h>
|
|
|
|
#else
|
|
|
|
# include <sys/types.h>
|
|
|
|
# if TIME_WITH_SYS_TIME
|
|
|
|
# include <sys/time.h>
|
|
|
|
# include <time.h>
|
|
|
|
# else
|
|
|
|
# if HAVE_SYS_TIME_H
|
|
|
|
# include <sys/time.h>
|
|
|
|
# else
|
|
|
|
# include <time.h>
|
|
|
|
# endif
|
|
|
|
# endif
|
|
|
|
#endif /* defined (vms) */
|
|
|
|
|
1999-12-29 09:20:26 -05:00
|
|
|
#ifndef TRUE
|
|
|
|
#define TRUE 1
|
|
|
|
#endif
|
|
|
|
#ifndef FALSE
|
|
|
|
#define FALSE 0
|
|
|
|
#endif
|
|
|
|
|
2000-05-22 10:12:12 -04:00
|
|
|
#include <curl/types.h>
|
1999-12-29 09:20:26 -05:00
|
|
|
|
2000-09-07 07:34:08 -04:00
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
1999-12-29 09:20:26 -05:00
|
|
|
struct HttpPost {
|
|
|
|
struct HttpPost *next; /* next entry in the list */
|
|
|
|
char *name; /* pointer to allocated name */
|
|
|
|
char *contents; /* pointer to allocated data contents */
|
|
|
|
char *contenttype; /* Content-Type */
|
|
|
|
struct HttpPost *more; /* if one field name has more than one file, this
|
|
|
|
link should link to following files */
|
|
|
|
long flags; /* as defined below */
|
|
|
|
#define HTTPPOST_FILENAME (1<<0) /* specified content is a file name */
|
2000-07-25 08:21:22 -04:00
|
|
|
#define HTTPPOST_READFILE (1<<1) /* specified content is a file name */
|
1999-12-29 09:20:26 -05:00
|
|
|
};
|
|
|
|
|
2000-06-08 11:13:03 -04:00
|
|
|
typedef int (*curl_progress_callback)(void *clientp,
|
|
|
|
size_t dltotal,
|
|
|
|
size_t dlnow,
|
|
|
|
size_t ultotal,
|
|
|
|
size_t ulnow);
|
|
|
|
|
|
|
|
typedef size_t (*curl_write_callback)(char *buffer,
|
|
|
|
size_t size,
|
|
|
|
size_t nitems,
|
2001-05-04 03:47:11 -04:00
|
|
|
void *outstream);
|
2000-06-08 11:13:03 -04:00
|
|
|
|
|
|
|
typedef size_t (*curl_read_callback)(char *buffer,
|
|
|
|
size_t size,
|
|
|
|
size_t nitems,
|
2001-05-04 03:47:11 -04:00
|
|
|
void *instream);
|
2000-06-08 11:13:03 -04:00
|
|
|
|
2000-11-06 17:53:50 -05:00
|
|
|
typedef int (*curl_passwd_callback)(void *clientp,
|
|
|
|
char *prompt,
|
|
|
|
char *buffer,
|
|
|
|
int buflen);
|
|
|
|
|
|
|
|
/* All possible error codes from all sorts of curl functions. Future versions
|
2000-11-02 09:34:46 -05:00
|
|
|
may return other values, stay prepared.
|
|
|
|
|
|
|
|
Always add new return codes last. Never *EVER* remove any. The return
|
|
|
|
codes must remain the same!
|
|
|
|
*/
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
typedef enum {
|
2000-05-22 10:12:12 -04:00
|
|
|
CURLE_OK = 0,
|
2001-03-08 04:04:43 -05:00
|
|
|
CURLE_UNSUPPORTED_PROTOCOL, /* 1 */
|
|
|
|
CURLE_FAILED_INIT, /* 2 */
|
|
|
|
CURLE_URL_MALFORMAT, /* 3 */
|
|
|
|
CURLE_URL_MALFORMAT_USER, /* 4 */
|
|
|
|
CURLE_COULDNT_RESOLVE_PROXY, /* 5 */
|
|
|
|
CURLE_COULDNT_RESOLVE_HOST, /* 6 */
|
|
|
|
CURLE_COULDNT_CONNECT, /* 7 */
|
|
|
|
CURLE_FTP_WEIRD_SERVER_REPLY, /* 8 */
|
|
|
|
CURLE_FTP_ACCESS_DENIED, /* 9 */
|
|
|
|
CURLE_FTP_USER_PASSWORD_INCORRECT, /* 10 */
|
|
|
|
CURLE_FTP_WEIRD_PASS_REPLY, /* 11 */
|
|
|
|
CURLE_FTP_WEIRD_USER_REPLY, /* 12 */
|
|
|
|
CURLE_FTP_WEIRD_PASV_REPLY, /* 13 */
|
|
|
|
CURLE_FTP_WEIRD_227_FORMAT, /* 14 */
|
|
|
|
CURLE_FTP_CANT_GET_HOST, /* 15 */
|
|
|
|
CURLE_FTP_CANT_RECONNECT, /* 16 */
|
|
|
|
CURLE_FTP_COULDNT_SET_BINARY, /* 17 */
|
|
|
|
CURLE_PARTIAL_FILE, /* 18 */
|
|
|
|
CURLE_FTP_COULDNT_RETR_FILE, /* 19 */
|
|
|
|
CURLE_FTP_WRITE_ERROR, /* 20 */
|
|
|
|
CURLE_FTP_QUOTE_ERROR, /* 21 */
|
|
|
|
CURLE_HTTP_NOT_FOUND, /* 22 */
|
|
|
|
CURLE_WRITE_ERROR, /* 23 */
|
|
|
|
CURLE_MALFORMAT_USER, /* 24 - user name is illegally specified */
|
|
|
|
CURLE_FTP_COULDNT_STOR_FILE, /* 25 - failed FTP upload */
|
|
|
|
CURLE_READ_ERROR, /* 26 - could open/read from file */
|
|
|
|
CURLE_OUT_OF_MEMORY, /* 27 */
|
|
|
|
CURLE_OPERATION_TIMEOUTED, /* 28 - the timeout time was reached */
|
|
|
|
CURLE_FTP_COULDNT_SET_ASCII, /* 29 - TYPE A failed */
|
|
|
|
CURLE_FTP_PORT_FAILED, /* 30 - FTP PORT operation failed */
|
|
|
|
CURLE_FTP_COULDNT_USE_REST, /* 31 - the REST command failed */
|
|
|
|
CURLE_FTP_COULDNT_GET_SIZE, /* 32 - the SIZE command failed */
|
|
|
|
CURLE_HTTP_RANGE_ERROR, /* 33 - RANGE "command" didn't work */
|
|
|
|
CURLE_HTTP_POST_ERROR, /* 34 */
|
|
|
|
CURLE_SSL_CONNECT_ERROR, /* 35 - wrong when connecting with SSL */
|
|
|
|
CURLE_FTP_BAD_DOWNLOAD_RESUME, /* 36 - couldn't resume download */
|
|
|
|
CURLE_FILE_COULDNT_READ_FILE, /* 37 */
|
|
|
|
CURLE_LDAP_CANNOT_BIND, /* 38 */
|
|
|
|
CURLE_LDAP_SEARCH_FAILED, /* 39 */
|
|
|
|
CURLE_LIBRARY_NOT_FOUND, /* 40 */
|
|
|
|
CURLE_FUNCTION_NOT_FOUND, /* 41 */
|
|
|
|
CURLE_ABORTED_BY_CALLBACK, /* 42 */
|
|
|
|
CURLE_BAD_FUNCTION_ARGUMENT, /* 43 */
|
|
|
|
CURLE_BAD_CALLING_ORDER, /* 44 */
|
|
|
|
CURLE_HTTP_PORT_FAILED, /* 45 - HTTP Interface operation failed */
|
|
|
|
CURLE_BAD_PASSWORD_ENTERED, /* 46 - my_getpass() returns fail */
|
|
|
|
CURLE_TOO_MANY_REDIRECTS , /* 47 - catch endless re-direct loops */
|
|
|
|
CURLE_UNKNOWN_TELNET_OPTION, /* 48 - User specified an unknown option */
|
|
|
|
CURLE_TELNET_OPTION_SYNTAX , /* 49 - Malformed telnet option */
|
2001-05-12 05:37:51 -04:00
|
|
|
CURLE_OBSOLETE, /* 50 - removed after 7.7.3 */
|
|
|
|
CURLE_SSL_PEER_CERTIFICATE, /* 51 - peer's certificate wasn't ok */
|
2001-04-17 09:21:13 -04:00
|
|
|
|
2001-03-08 04:04:43 -05:00
|
|
|
CURL_LAST /* never use! */
|
2000-05-22 10:12:12 -04:00
|
|
|
} CURLcode;
|
|
|
|
|
|
|
|
/* This is just to make older programs not break: */
|
|
|
|
#define CURLE_FTP_PARTIAL_FILE CURLE_PARTIAL_FILE
|
1999-12-29 09:20:26 -05:00
|
|
|
|
2000-05-26 04:12:14 -04:00
|
|
|
#define CURL_ERROR_SIZE 256
|
1999-12-29 09:20:26 -05:00
|
|
|
|
2000-05-22 10:12:12 -04:00
|
|
|
/* name is uppercase CURLOPT_<name>,
|
|
|
|
type is one of the defined CURLOPTTYPE_<type>
|
1999-12-29 09:20:26 -05:00
|
|
|
number is unique identifier */
|
2000-09-07 07:34:08 -04:00
|
|
|
#ifdef CINIT
|
|
|
|
#undef CINIT
|
|
|
|
#endif
|
|
|
|
#define CINIT(name,type,number) CURLOPT_ ## name = CURLOPTTYPE_ ## type + number
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* long may be 32 or 64 bits, but we should never depend on anything else
|
|
|
|
but 32 */
|
2000-05-22 10:12:12 -04:00
|
|
|
#define CURLOPTTYPE_LONG 0
|
|
|
|
#define CURLOPTTYPE_OBJECTPOINT 10000
|
|
|
|
#define CURLOPTTYPE_FUNCTIONPOINT 20000
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
typedef enum {
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(NOTHING, LONG, 0), /********* the first one is unused ************/
|
1999-12-29 09:20:26 -05:00
|
|
|
|
2001-05-04 03:47:11 -04:00
|
|
|
/* This is the FILE * or void * the regular output should be written to. */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(FILE, OBJECTPOINT, 1),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* The full URL to get/put */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(URL, OBJECTPOINT, 2),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* Port number to connect to, if other than default. Specify the CONF_PORT
|
2000-05-22 10:12:12 -04:00
|
|
|
flag in the CURLOPT_FLAGS to activate this */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(PORT, LONG, 3),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
2000-05-22 10:12:12 -04:00
|
|
|
/* Name of proxy to use. Specify the CONF_PROXY flag in the CURLOPT_FLAGS to
|
1999-12-29 09:20:26 -05:00
|
|
|
activate this */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(PROXY, OBJECTPOINT, 4),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* Name and password to use when fetching. Specify the CONF_USERPWD flag in
|
2000-05-22 10:12:12 -04:00
|
|
|
the CURLOPT_FLAGS to activate this */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(USERPWD, OBJECTPOINT, 5),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* Name and password to use with Proxy. Specify the CONF_PROXYUSERPWD
|
2000-05-22 10:12:12 -04:00
|
|
|
flag in the CURLOPT_FLAGS to activate this */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(PROXYUSERPWD, OBJECTPOINT, 6),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* Range to get, specified as an ASCII string. Specify the CONF_RANGE flag
|
2000-05-22 10:12:12 -04:00
|
|
|
in the CURLOPT_FLAGS to activate this */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(RANGE, OBJECTPOINT, 7),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
2000-05-22 10:12:12 -04:00
|
|
|
#if 0
|
1999-12-29 09:20:26 -05:00
|
|
|
/* Configuration flags */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(FLAGS, LONG, 8),
|
2000-05-22 10:12:12 -04:00
|
|
|
#endif
|
1999-12-29 09:20:26 -05:00
|
|
|
/* Specified file stream to upload from (use as input): */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(INFILE, OBJECTPOINT, 9),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
2000-05-26 04:12:14 -04:00
|
|
|
/* Buffer to receive error messages in, must be at least CURL_ERROR_SIZE
|
|
|
|
* bytes big. If this is not used, error messages go to stderr instead: */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(ERRORBUFFER, OBJECTPOINT, 10),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* Function that will be called to store the output (instead of fwrite). The
|
2000-05-26 04:12:14 -04:00
|
|
|
* parameters will use fwrite() syntax, make sure to follow them. */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(WRITEFUNCTION, FUNCTIONPOINT, 11),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* Function that will be called to read the input (instead of fread). The
|
2000-05-26 04:12:14 -04:00
|
|
|
* parameters will use fread() syntax, make sure to follow them. */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(READFUNCTION, FUNCTIONPOINT, 12),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* Time-out the read operation after this amount of seconds */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(TIMEOUT, LONG, 13),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
2000-05-26 04:12:14 -04:00
|
|
|
/* If the CURLOPT_INFILE is used, this can be used to inform libcurl about
|
|
|
|
* how large the file being sent really is. That allows better error
|
|
|
|
* checking and better verifies that the upload was succcessful. -1 means
|
|
|
|
* unknown size. */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(INFILESIZE, LONG, 14),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* POST input fields. */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(POSTFIELDS, OBJECTPOINT, 15),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* Set the referer page (needed by some CGIs) */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(REFERER, OBJECTPOINT, 16),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* Set the FTP PORT string (interface name, named or numerical IP address)
|
|
|
|
Use i.e '-' to use default address. */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(FTPPORT, OBJECTPOINT, 17),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* Set the User-Agent string (examined by some CGIs) */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(USERAGENT, OBJECTPOINT, 18),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* If the download receives less than "low speed limit" bytes/second
|
|
|
|
* during "low speed time" seconds, the operations is aborted.
|
|
|
|
* You could i.e if you have a pretty high speed connection, abort if
|
|
|
|
* it is less than 2000 bytes/sec during 20 seconds.
|
|
|
|
*/
|
|
|
|
|
|
|
|
/* Set the "low speed limit" */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(LOW_SPEED_LIMIT, LONG , 19),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* Set the "low speed time" */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(LOW_SPEED_TIME, LONG, 20),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* Set the continuation offset */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(RESUME_FROM, LONG, 21),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* Set cookie in request: */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(COOKIE, OBJECTPOINT, 22),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* This points to a linked list of headers, struct HttpHeader kind */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(HTTPHEADER, OBJECTPOINT, 23),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* This points to a linked list of post entries, struct HttpPost */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(HTTPPOST, OBJECTPOINT, 24),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* name of the file keeping your private SSL-certificate */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(SSLCERT, OBJECTPOINT, 25),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* password for the SSL-certificate */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(SSLCERTPASSWD, OBJECTPOINT, 26),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* send TYPE parameter? */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(CRLF, LONG, 27),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* send linked-list of QUOTE commands */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(QUOTE, OBJECTPOINT, 28),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
2001-05-04 03:47:11 -04:00
|
|
|
/* send FILE * or void * to store headers to, if you use a callback it
|
|
|
|
is simply passed to the callback unmodified */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(WRITEHEADER, OBJECTPOINT, 29),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
#ifdef MULTIDOC
|
|
|
|
/* send linked list of MoreDoc structs */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(MOREDOCS, OBJECTPOINT, 30),
|
1999-12-29 09:20:26 -05:00
|
|
|
#endif
|
|
|
|
|
|
|
|
/* point to a file to read the initial cookies from, also enables
|
|
|
|
"cookie awareness" */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(COOKIEFILE, OBJECTPOINT, 31),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* What version to specifly try to use.
|
|
|
|
3 = SSLv3, 2 = SSLv2, all else makes it try v3 first then v2 */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(SSLVERSION, LONG, 32),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* What kind of HTTP time condition to use, see defines */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(TIMECONDITION, LONG, 33),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* Time to use with the above condition. Specified in number of seconds
|
|
|
|
since 1 Jan 1970 */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(TIMEVALUE, LONG, 34),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* HTTP request, for odd commands like DELETE, TRACE and others */
|
|
|
|
/* OBSOLETE DEFINE, left for tradition only */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(HTTPREQUEST, OBJECTPOINT, 35),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* Custom request, for customizing the get command like
|
|
|
|
HTTP: DELETE, TRACE and others
|
|
|
|
FTP: to use a different list command
|
|
|
|
*/
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(CUSTOMREQUEST, OBJECTPOINT, 36),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* HTTP request, for odd commands like DELETE, TRACE and others */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(STDERR, OBJECTPOINT, 37),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
2000-06-16 09:19:30 -04:00
|
|
|
#if 0
|
|
|
|
/* Progress mode set alternative progress mode displays. Alternative
|
|
|
|
ones should now be made by the client, not the lib! */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(PROGRESSMODE, LONG, 38),
|
2000-06-16 09:19:30 -04:00
|
|
|
#endif
|
2000-01-10 18:53:10 -05:00
|
|
|
/* send linked-list of post-transfer QUOTE commands */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(POSTQUOTE, OBJECTPOINT, 39),
|
1999-12-29 09:20:26 -05:00
|
|
|
|
2000-03-02 18:07:25 -05:00
|
|
|
/* Pass a pointer to string of the output using full variable-replacement
|
|
|
|
as described elsewhere. */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(WRITEINFO, OBJECTPOINT, 40),
|
2000-03-02 18:07:25 -05:00
|
|
|
|
2000-05-22 10:12:12 -04:00
|
|
|
/* Previous FLAG bits */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(VERBOSE, LONG, 41), /* talk a lot */
|
|
|
|
CINIT(HEADER, LONG, 42), /* throw the header out too */
|
|
|
|
CINIT(NOPROGRESS, LONG, 43), /* shut off the progress meter */
|
|
|
|
CINIT(NOBODY, LONG, 44), /* use HEAD to get http document */
|
|
|
|
CINIT(FAILONERROR, LONG, 45), /* no output on http error codes >= 300 */
|
|
|
|
CINIT(UPLOAD, LONG, 46), /* this is an upload */
|
|
|
|
CINIT(POST, LONG, 47), /* HTTP POST method */
|
|
|
|
CINIT(FTPLISTONLY, LONG, 48), /* Use NLST when listing ftp dir */
|
|
|
|
|
|
|
|
CINIT(FTPAPPEND, LONG, 50), /* Append instead of overwrite on upload! */
|
|
|
|
CINIT(NETRC, LONG, 51), /* read user+password from .netrc */
|
|
|
|
CINIT(FOLLOWLOCATION, LONG, 52), /* use Location: Luke! */
|
2000-06-14 08:50:38 -04:00
|
|
|
|
|
|
|
/* This FTPASCII name is now obsolete, to be removed, use the TRANSFERTEXT
|
|
|
|
instead. It goes for more protocols than just ftp... */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(FTPASCII, LONG, 53), /* use TYPE A for transfer */
|
2000-06-14 08:50:38 -04:00
|
|
|
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(TRANSFERTEXT, LONG, 53), /* transfer data in text/ASCII format */
|
|
|
|
CINIT(PUT, LONG, 54), /* PUT the input file */
|
|
|
|
CINIT(MUTE, LONG, 55), /* force NOPROGRESS */
|
2000-05-22 10:12:12 -04:00
|
|
|
|
2000-06-08 11:13:03 -04:00
|
|
|
/* Function that will be called instead of the internal progress display
|
|
|
|
* function. This function should be defined as the curl_progress_callback
|
|
|
|
* prototype defines. */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(PROGRESSFUNCTION, FUNCTIONPOINT, 56),
|
2000-06-08 11:13:03 -04:00
|
|
|
|
2000-06-20 05:28:36 -04:00
|
|
|
/* Data passed to the progress callback */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(PROGRESSDATA, OBJECTPOINT, 57),
|
2000-06-08 11:13:03 -04:00
|
|
|
|
2000-06-20 05:28:36 -04:00
|
|
|
/* We want the referer field set automatically when following locations */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(AUTOREFERER, LONG, 58),
|
2000-06-20 05:28:36 -04:00
|
|
|
|
2000-07-25 03:38:08 -04:00
|
|
|
/* Port of the proxy, can be set in the proxy string as well with:
|
|
|
|
"[host]:[port]" */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(PROXYPORT, LONG, 59),
|
2000-07-25 03:38:08 -04:00
|
|
|
|
2000-08-24 12:27:04 -04:00
|
|
|
/* size of the POST input data, if strlen() is not good to use */
|
2000-09-07 07:34:08 -04:00
|
|
|
CINIT(POSTFIELDSIZE, LONG, 60),
|
2000-08-24 12:27:04 -04:00
|
|
|
|
2000-09-14 10:14:03 -04:00
|
|
|
/* tunnel non-http operations through a HTTP proxy */
|
|
|
|
CINIT(HTTPPROXYTUNNEL, LONG, 61),
|
|
|
|
|
2000-09-18 17:53:21 -04:00
|
|
|
/* Set the interface string to use as outgoing network interface */
|
|
|
|
CINIT(INTERFACE, OBJECTPOINT, 62),
|
|
|
|
|
2000-09-21 04:54:36 -04:00
|
|
|
/* Set the krb4 security level, this also enables krb4 awareness. This is a
|
|
|
|
* string, 'clear', 'safe', 'confidential' or 'private'. If the string is
|
|
|
|
* set but doesn't match one of these, 'private' will be used. */
|
|
|
|
CINIT(KRB4LEVEL, OBJECTPOINT, 63),
|
|
|
|
|
2000-10-30 18:15:15 -05:00
|
|
|
/* Set if we should verify the peer in ssl handshake, set 1 to verify. */
|
|
|
|
CINIT(SSL_VERIFYPEER, LONG, 64),
|
|
|
|
|
|
|
|
/* The CApath or CAfile used to validate the peer certificate
|
|
|
|
this option is used only if SSL_VERIFYPEER is true */
|
|
|
|
CINIT(CAINFO, OBJECTPOINT, 65),
|
|
|
|
|
2000-11-06 17:53:50 -05:00
|
|
|
/* Function pointer to replace the internal password prompt */
|
|
|
|
CINIT(PASSWDFUNCTION, FUNCTIONPOINT, 66),
|
|
|
|
|
|
|
|
/* Custom pointer that gets passed as first argument to the password
|
|
|
|
function */
|
|
|
|
CINIT(PASSWDDATA, OBJECTPOINT, 67),
|
2000-11-28 04:10:04 -05:00
|
|
|
|
|
|
|
/* Maximum number of http redirects to follow */
|
|
|
|
CINIT(MAXREDIRS, LONG, 68),
|
2000-11-06 17:53:50 -05:00
|
|
|
|
2000-11-22 08:59:41 -05:00
|
|
|
/* Pass a pointer to a time_t to get a possible date of the requested
|
|
|
|
document! Pass a NULL to shut it off. */
|
2000-11-28 04:10:04 -05:00
|
|
|
CINIT(FILETIME, OBJECTPOINT, 69),
|
2000-11-22 08:59:41 -05:00
|
|
|
|
2001-02-20 12:35:51 -05:00
|
|
|
/* This points to a linked list of telnet options */
|
|
|
|
CINIT(TELNETOPTIONS, OBJECTPOINT, 70),
|
|
|
|
|
2001-03-12 10:06:29 -05:00
|
|
|
/* Max amount of cached alive connections */
|
|
|
|
CINIT(MAXCONNECTS, LONG, 71),
|
|
|
|
|
|
|
|
/* What policy to use when closing connections when the cache is filled
|
|
|
|
up */
|
|
|
|
CINIT(CLOSEPOLICY, LONG, 72),
|
|
|
|
|
|
|
|
/* Callback to use when CURLCLOSEPOLICY_CALLBACK is set */
|
|
|
|
CINIT(CLOSEFUNCTION, FUNCTIONPOINT, 73),
|
|
|
|
|
|
|
|
/* Set to explicitly use a new connection for the upcoming transfer.
|
|
|
|
Do not use this unless you're absolutely sure of this, as it makes the
|
|
|
|
operation slower and is less friendly for the network. */
|
|
|
|
CINIT(FRESH_CONNECT, LONG, 74),
|
|
|
|
|
|
|
|
/* Set to explicitly forbid the upcoming transfer's connection to be re-used
|
|
|
|
when done. Do not use this unless you're absolutely sure of this, as it
|
|
|
|
makes the operation slower and is less friendly for the network. */
|
|
|
|
CINIT(FORBID_REUSE, LONG, 75),
|
|
|
|
|
2001-03-12 10:47:17 -05:00
|
|
|
/* Set to a file name that contains random data for libcurl to use to
|
|
|
|
seed the random engine when doing SSL connects. */
|
|
|
|
CINIT(RANDOM_FILE, OBJECTPOINT, 76),
|
|
|
|
|
|
|
|
/* Set to the Entropy Gathering Daemon socket pathname */
|
|
|
|
CINIT(EGDSOCKET, OBJECTPOINT, 77),
|
|
|
|
|
2001-03-15 09:37:41 -05:00
|
|
|
/* Time-out connect operations after this amount of seconds, if connects
|
|
|
|
are OK within this time, then fine... This only aborts the connect
|
|
|
|
phase. [Only works on unix-style/SIGALRM operating systems] */
|
|
|
|
CINIT(CONNECTTIMEOUT, LONG, 78),
|
|
|
|
|
2001-04-10 02:49:32 -04:00
|
|
|
/* Function that will be called to store headers (instead of fwrite). The
|
|
|
|
* parameters will use fwrite() syntax, make sure to follow them. */
|
|
|
|
CINIT(HEADERFUNCTION, FUNCTIONPOINT, 79),
|
|
|
|
|
2000-05-22 10:12:12 -04:00
|
|
|
CURLOPT_LASTENTRY /* the last unusued */
|
|
|
|
} CURLoption;
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
typedef enum {
|
|
|
|
TIMECOND_NONE,
|
|
|
|
|
|
|
|
TIMECOND_IFMODSINCE,
|
|
|
|
TIMECOND_IFUNMODSINCE,
|
|
|
|
TIMECOND_LASTMOD,
|
|
|
|
|
|
|
|
TIMECOND_LAST
|
|
|
|
} TimeCond;
|
|
|
|
|
|
|
|
#ifdef __BEOS__
|
|
|
|
#include <support/SupportDefs.h>
|
|
|
|
#endif
|
|
|
|
|
2000-08-02 03:16:26 -04:00
|
|
|
|
|
|
|
/* These functions are in the libcurl, they're here for portable reasons and
|
|
|
|
they are used by the 'curl' client. They really should be moved to some kind
|
|
|
|
of "portability library" since it has nothing to do with file transfers and
|
|
|
|
might be usable to other programs...
|
|
|
|
|
|
|
|
NOTE: they return TRUE if the strings match *case insensitively*.
|
|
|
|
*/
|
2001-03-14 03:53:31 -05:00
|
|
|
extern int (curl_strequal)(const char *s1, const char *s2);
|
|
|
|
extern int (curl_strnequal)(const char *s1, const char *s2, size_t n);
|
|
|
|
#define strequal(a,b) curl_strequal(a,b)
|
|
|
|
#define strnequal(a,b,c) curl_strnequal(a,b,c)
|
1999-12-29 09:20:26 -05:00
|
|
|
|
|
|
|
/* external form function */
|
2000-06-08 11:13:03 -04:00
|
|
|
int curl_formparse(char *string,
|
1999-12-29 09:20:26 -05:00
|
|
|
struct HttpPost **httppost,
|
|
|
|
struct HttpPost **last_post);
|
|
|
|
|
2000-11-17 09:21:07 -05:00
|
|
|
/* cleanup a form: */
|
|
|
|
void curl_formfree(struct HttpPost *form);
|
|
|
|
|
2000-06-08 11:13:03 -04:00
|
|
|
/* Unix and Win32 getenv function call, this returns a malloc()'ed string that
|
|
|
|
MUST be free()ed after usage is complete. */
|
|
|
|
char *curl_getenv(char *variable);
|
1999-12-29 09:20:26 -05:00
|
|
|
|
2000-10-02 02:29:39 -04:00
|
|
|
/* Returns a static ascii string of the libcurl version. */
|
1999-12-29 09:20:26 -05:00
|
|
|
char *curl_version(void);
|
|
|
|
|
2001-03-22 06:40:58 -05:00
|
|
|
/* Escape and unescape URL encoding in strings. The functions return a new
|
|
|
|
* allocated string or NULL if an error occurred. */
|
|
|
|
char *curl_escape(char *string, int length);
|
|
|
|
char *curl_unescape(char *string, int length);
|
|
|
|
|
1999-12-29 09:20:26 -05:00
|
|
|
/* This is the version number */
|
2001-05-07 07:12:03 -04:00
|
|
|
#define LIBCURL_VERSION "7.7.3"
|
|
|
|
#define LIBCURL_VERSION_NUM 0x070703
|
1999-12-29 09:20:26 -05:00
|
|
|
|
2000-10-02 02:29:39 -04:00
|
|
|
/* linked-list structure for the CURLOPT_QUOTE option (and other) */
|
1999-12-29 09:20:26 -05:00
|
|
|
struct curl_slist {
|
|
|
|
char *data;
|
|
|
|
struct curl_slist *next;
|
|
|
|
};
|
|
|
|
|
2001-03-03 11:28:59 -05:00
|
|
|
struct curl_slist *curl_slist_append(struct curl_slist *, const char *);
|
|
|
|
void curl_slist_free_all(struct curl_slist *);
|
1999-12-29 09:20:26 -05:00
|
|
|
|
2000-05-22 10:12:12 -04:00
|
|
|
/*
|
|
|
|
* NAME curl_getdate()
|
|
|
|
*
|
|
|
|
* DESCRIPTION
|
|
|
|
*
|
|
|
|
* Returns the time, in seconds since 1 Jan 1970 of the time string given in
|
|
|
|
* the first argument. The time argument in the second parameter is for cases
|
|
|
|
* where the specified time is relative now, like 'two weeks' or 'tomorrow'
|
|
|
|
* etc.
|
|
|
|
*/
|
|
|
|
time_t curl_getdate(const char *p, const time_t *now);
|
|
|
|
|
2000-10-02 02:29:39 -04:00
|
|
|
|
|
|
|
#define CURLINFO_STRING 0x100000
|
|
|
|
#define CURLINFO_LONG 0x200000
|
|
|
|
#define CURLINFO_DOUBLE 0x300000
|
|
|
|
#define CURLINFO_MASK 0x0fffff
|
|
|
|
#define CURLINFO_TYPEMASK 0xf00000
|
|
|
|
|
|
|
|
typedef enum {
|
|
|
|
CURLINFO_NONE, /* first, never use this */
|
|
|
|
CURLINFO_EFFECTIVE_URL = CURLINFO_STRING + 1,
|
|
|
|
CURLINFO_HTTP_CODE = CURLINFO_LONG + 2,
|
|
|
|
CURLINFO_TOTAL_TIME = CURLINFO_DOUBLE + 3,
|
|
|
|
CURLINFO_NAMELOOKUP_TIME = CURLINFO_DOUBLE + 4,
|
|
|
|
CURLINFO_CONNECT_TIME = CURLINFO_DOUBLE + 5,
|
|
|
|
CURLINFO_PRETRANSFER_TIME = CURLINFO_DOUBLE + 6,
|
|
|
|
CURLINFO_SIZE_UPLOAD = CURLINFO_DOUBLE + 7,
|
|
|
|
CURLINFO_SIZE_DOWNLOAD = CURLINFO_DOUBLE + 8,
|
|
|
|
CURLINFO_SPEED_DOWNLOAD = CURLINFO_DOUBLE + 9,
|
|
|
|
CURLINFO_SPEED_UPLOAD = CURLINFO_DOUBLE + 10,
|
2000-10-09 17:35:40 -04:00
|
|
|
CURLINFO_HEADER_SIZE = CURLINFO_LONG + 11,
|
|
|
|
CURLINFO_REQUEST_SIZE = CURLINFO_LONG + 12,
|
2000-10-30 18:15:15 -05:00
|
|
|
CURLINFO_SSL_VERIFYRESULT = CURLINFO_LONG + 13,
|
2000-11-22 08:59:41 -05:00
|
|
|
CURLINFO_FILETIME = CURLINFO_LONG + 14,
|
2000-10-02 02:29:39 -04:00
|
|
|
|
2001-02-04 15:03:30 -05:00
|
|
|
CURLINFO_CONTENT_LENGTH_DOWNLOAD = CURLINFO_DOUBLE + 15,
|
|
|
|
CURLINFO_CONTENT_LENGTH_UPLOAD = CURLINFO_DOUBLE + 16,
|
|
|
|
|
|
|
|
CURLINFO_LASTONE = 17
|
2000-10-02 02:29:39 -04:00
|
|
|
} CURLINFO;
|
|
|
|
|
2001-03-04 10:32:44 -05:00
|
|
|
/* unfortunately, the easy.h include file needs the options and info stuff
|
|
|
|
before it can be included! */
|
|
|
|
#include <curl/easy.h> /* nothing in curl is fun without the easy stuff */
|
|
|
|
|
2001-02-20 12:35:51 -05:00
|
|
|
typedef enum {
|
|
|
|
CURLCLOSEPOLICY_NONE, /* first, never use this */
|
|
|
|
|
|
|
|
CURLCLOSEPOLICY_OLDEST,
|
|
|
|
CURLCLOSEPOLICY_LEAST_RECENTLY_USED,
|
|
|
|
CURLCLOSEPOLICY_LEAST_TRAFFIC,
|
|
|
|
CURLCLOSEPOLICY_SLOWEST,
|
|
|
|
CURLCLOSEPOLICY_CALLBACK,
|
|
|
|
|
|
|
|
CURLCLOSEPOLICY_LAST /* last, never use this */
|
|
|
|
} curl_closepolicy;
|
|
|
|
|
|
|
|
|
2000-09-07 07:34:08 -04:00
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
2000-05-22 10:12:12 -04:00
|
|
|
#endif /* __CURL_CURL_H */
|