Skip to content
Snippets Groups Projects
url.c 90.2 KiB
Newer Older
  • Learn to ignore specific revisions
  • /***************************************************************************
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
     *                                  _   _ ____  _     
     *  Project                     ___| | | |  _ \| |    
     *                             / __| | | | |_) | |    
     *                            | (__| |_| |  _ <| |___ 
     *                             \___|\___/|_| \_\_____|
     *
    
     * Copyright (C) 1998 - 2002, Daniel Stenberg, <daniel@haxx.se>, et al.
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
     *
    
     * This software is licensed as described in the file COPYING, which
     * you should have received as part of this distribution. The terms
     * are also available at http://curl.haxx.se/docs/copyright.html.
     * 
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
     * 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 COPYING file.
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
     *
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
     * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
     * KIND, either express or implied.
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
     *
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
     * $Id$
    
     ***************************************************************************/
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
    
    /* -- WIN32 approved -- */
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
    #include <stdio.h>
    #include <string.h>
    #include <stdarg.h>
    #include <stdlib.h>
    #include <ctype.h>
    #include <sys/types.h>
    #include <sys/stat.h>
    
    #include <errno.h>
    
    #if defined(WIN32) && !defined(__GNUC__) || defined(__MINGW32__)
    #include <winsock.h>
    #include <time.h>
    #include <io.h>
    #else
    #ifdef HAVE_SYS_SOCKET_H
    #include <sys/socket.h>
    #endif
    #include <netinet/in.h>
    #include <sys/time.h>
    #include <sys/resource.h>
    #ifdef HAVE_UNISTD_H
    #include <unistd.h>
    #endif
    #include <netdb.h>
    #ifdef HAVE_ARPA_INET_H
    #include <arpa/inet.h>
    #endif
    #ifdef HAVE_NET_IF_H
    #include <net/if.h>
    #endif
    #include <sys/ioctl.h>
    #include <signal.h>
    
    #ifdef HAVE_SYS_PARAM_H
    #include <sys/param.h>
    #endif
    
    #ifdef HAVE_SYS_SELECT_H
    #include <sys/select.h>
    #endif
    
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
    #ifdef VMS
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
    #include <in.h>
    #include <inet.h>
    #endif
    
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
    #ifndef HAVE_SELECT
    #error "We can't compile without select() support!"
    #endif
    #ifndef HAVE_SOCKET
    #error "We can't compile without socket() support!"
    #endif
    
    #endif
    
    #include "urldata.h"
    #include "netrc.h"
    
    #include "formdata.h"
    #include "base64.h"
    #include "ssluse.h"
    #include "hostip.h"
    #include "if2ip.h"
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
    #include "sendf.h"
    #include "getpass.h"
    #include "progress.h"
    #include "cookie.h"
    
    #include "strequal.h"
    
    #include "strtok.h"
    
    #include "share.h"
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
    
    /* And now for the protocols */
    #include "ftp.h"
    #include "dict.h"
    #include "telnet.h"
    #include "http.h"
    #include "file.h"
    #include "ldap.h"
    
    #include "connect.h"
    
    
    #include <curl/types.h>
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
    
    
    #if defined(HAVE_INET_NTOA_R) && !defined(HAVE_INET_NTOA_R_DECL)
    #include "inet_ntoa_r.h"
    #endif
    
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
    #define _MPRINTF_REPLACE /* use our functions only */
    #include <curl/mprintf.h>
    
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
    #ifdef KRB4
    #include "security.h"
    #endif
    
    /* The last #include file should be: */
    #ifdef MALLOCDEBUG
    #include "memdebug.h"
    #endif
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
    
    
    /* Local static prototypes */
    
    static int ConnectionKillOne(struct SessionHandle *data);
    static bool ConnectionExists(struct SessionHandle *data,
    
                                 struct connectdata *needle,
                                 struct connectdata **usethis);
    
    static unsigned int ConnectionStore(struct SessionHandle *data,
    
                                        struct connectdata *conn);
    
    #if !defined(WIN32)||defined(__CYGWIN32__)
    #ifndef RETSIGTYPE
    #define RETSIGTYPE void
    #endif
    
    extern sigjmp_buf curl_jmpenv;
    
    static
    RETSIGTYPE alarmfunc(int signal)
    {
      /* this is for "-ansi -Wall -pedantic" to stop complaining!   (rabe) */
      (void)signal;
    
    #ifdef HAVE_SIGSETJMP
      siglongjmp(curl_jmpenv, 1);
    #endif
    
    
    /*
     * This is the internal function curl_easy_cleanup() calls. This should
     * cleanup and free all resources associated with this sessionhandle.
     *
     * NOTE: if we ever add something that attempts to write to a socket or
     * similar here, we must ignore SIGPIPE first. It is currently only done
     * when curl_easy_perform() is invoked.
     */
    
    
    CURLcode Curl_close(struct SessionHandle *data)
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
    {
    
      /* Loop through all open connections and kill them one by one */
      while(-1 != ConnectionKillOne(data));
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
    
    
      /* Close down all open SSL info and sessions */
    
      /* No longer a dirty share, if it exists */
      if (data->share)
        data->share->dirty--;
    
    
      if(data->change.cookielist) /* clean up list if any */
        curl_slist_free_all(data->change.cookielist);
    
    
      if(data->state.auth_host)
        free(data->state.auth_host);
    
    
      if(data->change.proxy_alloc)
        free(data->change.proxy);
    
      if(data->change.referer_alloc)
        free(data->change.referer);
    
      if(data->change.url_alloc)
        free(data->change.url);
    
      if(data->state.headerbuff)
        free(data->state.headerbuff);
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
        /* we have a "destination" for all the cookies to get dumped to */
    
        Curl_cookie_output(data->cookies, data->set.cookiejar);
    
      Curl_cookie_cleanup(data->cookies);
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
    
    
      /* free the connection cache */
    
      if(data->info.contenttype)
        free(data->info.contenttype);
    
    
      return CURLE_OK;
    }
    
    int my_getpass(void *clientp, const char *prompt, char* buffer, int buflen )
    
      char *retbuf;
    
      clientp=NULL; /* prevent compiler warning */
    
    
      retbuf = getpass_r(prompt, buffer, buflen);
      if(NULL == retbuf)
        return 1;
      else
        return 0; /* success */
    
    CURLcode Curl_open(struct SessionHandle **curl)
    
    {
      /* We don't yet support specifying the URL at this point */
    
      /* Very simple start-up: alloc the struct, init it with zeroes and return */
    
      data = (struct SessionHandle *)malloc(sizeof(struct SessionHandle));
    
      if(!data)
        /* this is a very serious error */
        return CURLE_OUT_OF_MEMORY;
      
      memset(data, 0, sizeof(struct SessionHandle));
    
      /* We do some initial setup here, all those fields that can't be just 0 */
    
      data->state.headerbuff=(char*)malloc(HEADERSIZE);
      if(!data->state.headerbuff) {
        free(data); /* free the memory again */
        return CURLE_OUT_OF_MEMORY;
      }
    
      data->set.out = stdout; /* default output to stdout */
      data->set.in  = stdin;  /* default input from stdin */
      data->set.err  = stderr;  /* default stderr to stderr */
      
      /* use fwrite as default function to store output */
      data->set.fwrite = (curl_write_callback)fwrite;
    
      /* use fread as default function to read input */
      data->set.fread = (curl_read_callback)fread;
      
      /* set the default passwd function */
      data->set.fpasswd = my_getpass;
    
      data->set.infilesize = -1; /* we don't know any size */
    
      data->state.current_speed = -1; /* init to negative == impossible */
    
      data->set.httpreq = HTTPREQ_GET; /* Default HTTP request */
    
      data->set.ftp_use_epsv = TRUE;   /* FTP defaults to EPSV operations */
    
      data->set.dns_cache_timeout = 60; /* Timeout every 60 seconds by default */
      
    
      /* make libcurl quiet by default: */
      data->set.hide_progress = TRUE;  /* CURLOPT_NOPROGRESS changes these */
      data->progress.flags |= PGRS_HIDE;
    
      /* Set the default size of the SSL session ID cache */
      data->set.ssl.numsessions = 5;
    
      data->set.proxytype = CURLPROXY_HTTP; /* defaults to HTTP proxy */
    
    
      /* create an array with connection data struct pointers */
      data->state.numconnects = 5; /* hard-coded right now */
      data->state.connects = (struct connectdata **)
        malloc(sizeof(struct connectdata *) * data->state.numconnects);
      
      if(!data->state.connects) {
        free(data);
        return CURLE_OUT_OF_MEMORY;
      }
    
    
      /*
       * libcurl 7.10 introduces SSL verification *by default*! This needs to be
       * switched off unless wanted.
       */
      data->set.ssl.verifypeer = TRUE;
      data->set.ssl.verifyhost = 2;
    #ifdef CURL_CA_BUNDLE
      /* This is our prefered CA cert bundle since install time */
    
      data->set.ssl.CAfile = (char *)CURL_CA_BUNDLE;
    
      memset(data->state.connects, 0,
             sizeof(struct connectdata *)*data->state.numconnects);
    
    CURLcode Curl_setopt(struct SessionHandle *data, CURLoption option, ...)
    
    {
      va_list param;
      char *cookiefile;
    
      va_start(param, option);
    
      switch(option) {
    
      case CURLOPT_DNS_CACHE_TIMEOUT:
        data->set.dns_cache_timeout = va_arg(param, int);
        break;
      case CURLOPT_DNS_USE_GLOBAL_CACHE: 
        {
    
          int use_cache = va_arg(param, int);
          if (use_cache) {
            Curl_global_host_cache_init();
          }
    
          data->set.global_dns_cache = use_cache;
        }
        break;
    
      case CURLOPT_SSL_CIPHER_LIST:
        /* set a list of cipher we want to use in the SSL connection */
        data->set.ssl.cipher_list = va_arg(param, char *);
        break;
    
    
      case CURLOPT_RANDOM_FILE:
        /*
         * This is the path name to a file that contains random data to seed
         * the random SSL stuff with. The file is only used for reading.
         */
    
        data->set.ssl.random_file = va_arg(param, char *);
    
        break;
      case CURLOPT_EGDSOCKET:
        /*
         * The Entropy Gathering Daemon socket pathname
         */
    
        data->set.ssl.egdsocket = va_arg(param, char *);
    
      case CURLOPT_MAXCONNECTS:
        /*
         * Set the absolute number of maximum simultaneous alive connection that
         * libcurl is allowed to have.
         */
        {
          long newconnects= va_arg(param, long);
          struct connectdata **newptr;
    
    
          if(newconnects < data->state.numconnects) {
    
            /* Since this number is *decreased* from the existing number, we must
               close the possibly open connections that live on the indexes that
               are being removed! */
            int i;
    
            for(i=newconnects; i< data->state.numconnects; i++)
              Curl_disconnect(data->state.connects[i]);
    
          }
          if(newconnects) {
            newptr= (struct connectdata **)
    
                      sizeof(struct connectdata *) * newconnects);
            if(!newptr)
              /* we closed a few connections in vain, but so what? */
              return CURLE_OUT_OF_MEMORY;
    
            data->state.connects = newptr;
            data->state.numconnects = newconnects;
    
          }
          else {
            /* zero makes NO cache at all */
    
            if(data->state.connects)
              free(data->state.connects);
            data->state.connects=NULL;
            data->state.numconnects=0;
    
          }
        }
        break;
      case CURLOPT_FORBID_REUSE:
        /*
         * When this transfer is done, it must not be left to be reused by a
         * subsequent transfer but shall be closed immediately.
         */
    
        data->set.reuse_forbid = va_arg(param, long)?TRUE:FALSE;
    
        break;
      case CURLOPT_FRESH_CONNECT:
        /*
         * This transfer shall not use a previously cached connection but
         * should be made with a fresh new connect!
         */
    
        data->set.reuse_fresh = va_arg(param, long)?TRUE:FALSE;
    
      case CURLOPT_VERBOSE:
    
        /*
         * Verbose means infof() calls that give a lot of information about
         * the connection and transfer procedures as well as internal choices.
         */
    
        data->set.verbose = va_arg(param, long)?TRUE:FALSE;
    
        break;
      case CURLOPT_HEADER:
    
        /*
         * Set to include the header in the general data output stream.
         */
    
        data->set.http_include_header = va_arg(param, long)?TRUE:FALSE;
    
        break;
      case CURLOPT_NOPROGRESS:
    
        /*
         * Shut off the internal supported progress meter
         */
    
        data->set.hide_progress = va_arg(param, long)?TRUE:FALSE;
        if(data->set.hide_progress)
    
          data->progress.flags |= PGRS_HIDE;
    
        else
          data->progress.flags &= ~PGRS_HIDE;
    
        break;
      case CURLOPT_NOBODY:
    
        /*
         * Do not include the body part in the output data stream.
         */
    
        data->set.no_body = va_arg(param, long)?TRUE:FALSE;
    
        break;
      case CURLOPT_FAILONERROR:
    
        /*
         * Don't output the >=300 error code HTML-page, but instead only
         * return error.
         */
    
        data->set.http_fail_on_error = va_arg(param, long)?TRUE:FALSE;
    
        break;
      case CURLOPT_UPLOAD:
    
        /*
         * We want to sent data to the remote host
         */
    
        data->set.upload = va_arg(param, long)?TRUE:FALSE;
        if(data->set.upload)
    
          /* If this is HTTP, PUT is what's needed to "upload" */
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
      case CURLOPT_FILETIME:
    
        /*
         * Try to get the file time of the remote document. The time will
         * later (possibly) become available using curl_easy_getinfo().
         */
    
        data->set.get_filetime = va_arg(param, long)?TRUE:FALSE;
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
        break;
    
      case CURLOPT_FTPLISTONLY:
    
        /*
         * An FTP option that changes the command to one that asks for a list
         * only, no file info details.
         */
    
        data->set.ftp_list_only = va_arg(param, long)?TRUE:FALSE;
    
        break;
      case CURLOPT_FTPAPPEND:
    
        /*
         * We want to upload and append to an existing (FTP) file.
         */
    
        data->set.ftp_append = va_arg(param, long)?TRUE:FALSE;
    
        break;
      case CURLOPT_NETRC:
    
        /*
         * Parse the $HOME/.netrc file
         */
    
        data->set.use_netrc = va_arg(param, long);
    
        break;
      case CURLOPT_FOLLOWLOCATION:
    
        /*
         * Follow Location: header hints on a HTTP-server.
         */
    
        data->set.http_follow_location = va_arg(param, long)?TRUE:FALSE;
    
      case CURLOPT_HTTP_VERSION:
        /*
         * This sets a requested HTTP version to be used. The value is one of
         * the listed enums in curl/curl.h.
         */
        data->set.httpversion = va_arg(param, long);
        break;
    
         * This option was previously named 'FTPASCII'. Renamed to work with
         * more protocols than merely FTP.
         *
         * Transfer using ASCII (instead of BINARY).
    
        data->set.ftp_ascii = va_arg(param, long)?TRUE:FALSE;
    
        break;
      case CURLOPT_PUT:
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
         * Use the HTTP PUT request to transfer data if this is TRUE.  If this is
         * FALSE, don't set the httpreq. We can't know what to revert it to!
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
        if(va_arg(param, long))
    
        break;
      case CURLOPT_TIMECONDITION:
    
        /*
         * Set HTTP time condition. This must be one of the defines in the
         * curl/curl.h header file.
         */
    
        data->set.timecondition = va_arg(param, long);
    
      case CURLOPT_TIMEVALUE:
    
        /*
         * This is the value to compare with the remote document with the
         * method set with CURLOPT_TIMECONDITION
         */
    
        data->set.timevalue = va_arg(param, long);
    
      case CURLOPT_SSLVERSION:
    
        /*
         * Set explicit SSL version to try to connect with, as some SSL
         * implementations are lame.
         */
    
        data->set.ssl.version = va_arg(param, long);
    
      case CURLOPT_COOKIESESSION:
        /*
         * Set this option to TRUE to start a new "cookie session". It will
         * prevent the forthcoming read-cookies-from-file actions to accept
         * cookies that are marked as being session cookies, as they belong to a
         * previous session.
         *
         * In the original Netscape cookie spec, "session cookies" are cookies
         * with no expire date set. RFC2109 describes the same action if no
         * 'Max-Age' is set and RFC2965 includes the RFC2109 description and adds
         * a 'Discard' action that can enforce the discard even for cookies that
         * have a Max-Age.
         *
         * We run mostly with the original cookie spec, as hardly anyone implements
         * anything else.
         */
        data->set.cookiesession = (bool)va_arg(param, long);
        break;
    
    
      case CURLOPT_COOKIEFILE:
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
         * Set cookie file to read and parse. Can be used multiple times.
    
        cookiefile = (char *)va_arg(param, void *);
    
          /* append the cookie file name to the list of file names, and deal with
             them later */
          data->change.cookielist =
            curl_slist_append(data->change.cookielist, cookiefile);
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
    
      case CURLOPT_COOKIEJAR:
        /*
         * Set cookie file name to dump all cookies to when we're done.
         */
    
        data->set.cookiejar = (char *)va_arg(param, void *);
    
        /*
         * Activate the cookie parser. This may or may not already
         * have been made.
         */
    
        data->cookies = Curl_cookie_init(NULL, data->cookies,
                                         data->set.cookiesession);
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
        break;
    
      case CURLOPT_WRITEHEADER:
    
         * Custom pointer to pass the header write callback function
    
        data->set.writeheader = (void *)va_arg(param, void *);
    
      case CURLOPT_COOKIE:
    
        /*
         * Cookie string to send to the remote server in the request.
         */
    
        data->set.cookie = va_arg(param, char *);
    
      case CURLOPT_ERRORBUFFER:
    
        /*
         * Error buffer provided by the caller to get the human readable
         * error string in.
         */
    
        data->set.errorbuffer = va_arg(param, char *);
    
      case CURLOPT_FILE:
    
        /*
         * FILE pointer to write to or include in the data write callback
         */
    
        data->set.out = va_arg(param, FILE *);
    
      case CURLOPT_FTPPORT:
    
        /*
         * Use FTP PORT, this also specifies which IP address to use
         */
    
        data->set.ftpport = va_arg(param, char *);
        data->set.ftp_use_port = data->set.ftpport?1:0;
    
    
      case CURLOPT_FTP_USE_EPSV:
        data->set.ftp_use_epsv = va_arg(param, long)?TRUE:FALSE;
        break;
    
    
      case CURLOPT_HTTPHEADER:
    
        /*
         * Set a list with HTTP headers to use (or replace internals with)
         */
    
        data->set.headers = va_arg(param, struct curl_slist *);
    
      case CURLOPT_CUSTOMREQUEST:
    
        /*
         * Set a custom string to use as request
         */
    
        data->set.customrequest = va_arg(param, char *);
    
    
        /* we don't set
           data->set.httpreq = HTTPREQ_CUSTOM;
           here, we continue as if we were using the already set type
           and this just changes the actual request keyword */
    
      case CURLOPT_HTTPPOST:
    
        /*
         * Set to make us do HTTP POST
         */
    
        data->set.httppost = va_arg(param, struct HttpPost *);
        if(data->set.httppost)
          data->set.httpreq = HTTPREQ_POST_FORM;
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
    
      case CURLOPT_HTTPGET:
        /*
         * Set to force us do HTTP GET
         */
    
          data->set.upload = FALSE; /* switch off upload */
        }
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
        break;
    
    
      case CURLOPT_INFILE:
    
        /*
         * FILE pointer to read the file to be uploaded from. Or possibly
         * used as argument to the read callback.
         */
    
        data->set.in = va_arg(param, FILE *);
    
      case CURLOPT_INFILESIZE:
    
        /*
         * If known, this should inform curl about the file size of the
         * to-be-uploaded file.
         */
    
        data->set.infilesize = va_arg(param, long);
    
      case CURLOPT_LOW_SPEED_LIMIT:
    
        /*
         * The low speed limit that if transfers are below this for
         * CURLOPT_LOW_SPEED_TIME, the transfer is aborted.
         */
    
        data->set.low_speed_limit=va_arg(param, long);
    
      case CURLOPT_LOW_SPEED_TIME:
    
        /*
         * The low speed time that if transfers are below the set
         * CURLOPT_LOW_SPEED_LIMIT during this time, the transfer is aborted.
         */
    
        data->set.low_speed_time=va_arg(param, long);
    
      case CURLOPT_URL:
    
          /* the already set URL is allocated, free it first! */
    
          free(data->change.url);
          data->change.url_alloc=FALSE;
    
        data->set.set_url = va_arg(param, char *);
        data->change.url = data->set.set_url;
    
      case CURLOPT_PORT:
    
        /*
         * The port number to use when getting the URL
         */
    
        data->set.use_port = va_arg(param, long);
    
        /* Does this option serve a purpose anymore? Yes it does, when
           CURLOPT_POSTFIELDS isn't used and the POST data is read off the
           callback! */
    
    Daniel Stenberg's avatar
    Daniel Stenberg committed
        if(va_arg(param, long))
    
      case CURLOPT_POSTFIELDS:
    
        /*
         * A string with POST data. Makes curl HTTP POST.
         */
    
        data->set.postfields = va_arg(param, char *);
        if(data->set.postfields)
          data->set.httpreq = HTTPREQ_POST;
    
      case CURLOPT_POSTFIELDSIZE:
    
        /*
         * The size of the POSTFIELD data, if curl should now do a strlen
         * to find out. Enables binary posts.
         */
    
        data->set.postfieldsize = va_arg(param, long);
    
      case CURLOPT_REFERER:
    
        /*
         * String to set in the HTTP Referer: field.
         */
    
        if(data->change.referer_alloc) {
          free(data->change.referer);
          data->change.referer_alloc = FALSE;
        }
        data->set.set_referer = va_arg(param, char *);
        data->change.referer = data->set.set_referer;
    
        /*
         * Switch on automatic referer that gets set if curl follows locations.
         */
    
        data->set.http_auto_referer = va_arg(param, long)?1:0;
    
      case CURLOPT_PROXY:
    
         * Set proxy server:port to use as HTTP proxy.
         *
         * If the proxy is set to "" we explicitly say that we don't want to use a
         * proxy (even though there might be environment variables saying so).
         *
         * Setting it to NULL, means no proxy but allows the environment variables
         * to decide for us.
    
          /*
           * The already set string is allocated, free that first
           */
    
          data->change.proxy_alloc=FALSE;;
          free(data->change.proxy);
    
        data->set.set_proxy = va_arg(param, char *);
        data->change.proxy = data->set.set_proxy;
    
      case CURLOPT_HTTPPROXYTUNNEL:
    
        /*
         * Tunnel operations through the proxy instead of normal proxy use
         */
    
        data->set.tunnel_thru_httpproxy = va_arg(param, long)?TRUE:FALSE;
    
      case CURLOPT_PROXYPORT:
    
        /*
         * Explicitly set HTTP proxy port number.
         */
    
        data->set.proxyport = va_arg(param, long);
    
      case CURLOPT_TIMEOUT:
    
        /*
         * The maximum time you allow curl to use for a single transfer
         * operation.
         */
    
        data->set.timeout = va_arg(param, long);
    
      case CURLOPT_CONNECTTIMEOUT:
        /*
         * The maximum time you allow curl to use to connect.
         */
    
        data->set.connecttimeout = va_arg(param, long);
    
      case CURLOPT_MAXREDIRS:
    
        /*
         * The maximum amount of hops you allow curl to follow Location:
         * headers. This should mostly be used to detect never-ending loops.
         */
    
        data->set.maxredirs = va_arg(param, long);
    
      case CURLOPT_USERAGENT:
    
        /*
         * String to use in the HTTP User-Agent field
         */
    
        data->set.useragent = va_arg(param, char *);
    
      case CURLOPT_ENCODING:
        /*
         * String to use at the value of Accept-Encoding header. 08/28/02 jhrg
         */
        data->set.encoding = va_arg(param, char *);
        break;
    
    
      case CURLOPT_USERPWD:
    
        /*
         * user:password to use in the operation
         */
    
        data->set.userpwd = va_arg(param, char *);
    
      case CURLOPT_POSTQUOTE:
    
        /*
         * List of RAW FTP commands to use after a transfer 
         */
    
        data->set.postquote = va_arg(param, struct curl_slist *);
    
      case CURLOPT_PREQUOTE:
        /*
         * List of RAW FTP commands to use prior to RETR (Wesley Laxton)
         */
        data->set.prequote = va_arg(param, struct curl_slist *);
        break;
    
      case CURLOPT_QUOTE:
        /*
         * List of RAW FTP commands to use before a transfer 
         */
    
        data->set.quote = va_arg(param, struct curl_slist *);
    
        data->set.fprogress = va_arg(param, curl_progress_callback);
    
        if(data->set.fprogress)
          data->progress.callback = TRUE; /* no longer internal */
        else
          data->progress.callback = FALSE; /* NULL enforces internal */
    
    
        /*
         * Custom client data to pass to the progress callback
         */
    
        data->set.progress_client = va_arg(param, void *);
    
      case CURLOPT_PASSWDFUNCTION:
    
        data->set.fpasswd = va_arg(param, curl_passwd_callback);
    
        /*
         * if the callback provided is null, reset the default callback
         */
        if(!data->set.fpasswd)
        {
          data->set.fpasswd = my_getpass;
        }
    
        break;
      case CURLOPT_PASSWDDATA:
    
        /*
         * Custom client data to pass to the password callback
         */
    
        data->set.passwd_client = va_arg(param, void *);
    
      case CURLOPT_PROXYUSERPWD:
    
        /*
         * user:password needed to use the proxy
         */
    
        data->set.proxyuserpwd = va_arg(param, char *);
    
      case CURLOPT_RANGE:
    
        /*
         * What range of the file you want to transfer
         */
    
        data->set.set_range = va_arg(param, char *);
    
      case CURLOPT_RESUME_FROM:
    
        /*
         * Resume transfer at the give file position
         */
    
        data->set.set_resume_from = va_arg(param, long);
    
      case CURLOPT_DEBUGFUNCTION:
        /*
         * stderr write callback.
         */
        data->set.fdebug = va_arg(param, curl_debug_callback);
        /*
         * if the callback provided is NULL, it'll use the default callback
         */
        break;
      case CURLOPT_DEBUGDATA:
        /*
         * Set to a void * that should receive all error writes. This
         * defaults to CURLOPT_STDERR for normal operations.
         */
        data->set.debugdata = va_arg(param, void *);
    
      case CURLOPT_STDERR:
    
        /*
         * Set to a FILE * that should receive all error writes. This
         * defaults to stderr for normal operations.
         */
    
        data->set.err = va_arg(param, FILE *);
    
        if(!data->set.err)
          data->set.err = stderr;
    
      case CURLOPT_HEADERFUNCTION:
        /*
         * Set header write callback
         */
    
        data->set.fwrite_header = va_arg(param, curl_write_callback);
    
      case CURLOPT_WRITEFUNCTION:
    
        data->set.fwrite = va_arg(param, curl_write_callback);
    
      case CURLOPT_READFUNCTION:
    
        data->set.fread = va_arg(param, curl_read_callback);
    
      case CURLOPT_SSLCERT:
    
        /*
         * String that holds file name of the SSL certificate to use
         */
    
        data->set.cert = va_arg(param, char *);
    
      case CURLOPT_SSLCERTTYPE:
    
         * String that holds file type of the SSL certificate to use
    
        data->set.cert_type = va_arg(param, char *);
        break;
      case CURLOPT_SSLKEY:
        /*
         * String that holds file name of the SSL certificate to use
         */
        data->set.key = va_arg(param, char *);
        break;
      case CURLOPT_SSLKEYTYPE:
        /*
         * String that holds file type of the SSL certificate to use
         */
        data->set.key_type = va_arg(param, char *);
        break;
      case CURLOPT_SSLKEYPASSWD:
        /*
         * String that holds the SSL private key password.
         */
        data->set.key_passwd = va_arg(param, char *);
        break;
      case CURLOPT_SSLENGINE:
        /*
         * String that holds the SSL crypto engine.
         */
    #ifdef HAVE_OPENSSL_ENGINE_H
        {
          const char *cpTemp = va_arg(param, char *);
          ENGINE     *e;
          if (cpTemp && cpTemp[0]) {
            e = ENGINE_by_id(cpTemp);
            if (e) {
              if (data->engine) {
                ENGINE_free(data->engine);
              }
              data->engine = e;
            }
            else {
              failf(data, "SSL Engine '%s' not found", cpTemp);
              return CURLE_SSL_ENGINE_NOTFOUND;
            }
          }
        }
    #else
        return CURLE_SSL_ENGINE_NOTFOUND;
    #endif
        break;
      case CURLOPT_SSLENGINE_DEFAULT:
        /*
         * flag to set engine as default.
         */
    #ifdef HAVE_OPENSSL_ENGINE_H
        if (data->engine) {
          if (ENGINE_set_default(data->engine, ENGINE_METHOD_ALL) > 0) {
    #ifdef DEBUG
            fprintf(stderr,"set default crypto engine\n");
    #endif
          }
          else {
    #ifdef DEBUG
            failf(data, "set default crypto engine failed");
    #endif
            return CURLE_SSL_ENGINE_SETFAILED;
          }
        }
    #endif
    
      case CURLOPT_CRLF: