DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

CURLMOPT_PUSHDATA(3)




CURLMOPT_PUSHDATA(3)curl_multi_setopt optionsCURLMOPT_PUSHDATA(3)


NAME

     CURLMOPT_PUSHDATA - pointer to pass to push callback


SYNOPSIS

     #include <curl/curl.h>

     CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_PUSHDATA, void *pointer);


DESCRIPTION

     Set  pointer  to  pass  as  the   last   argument   to   the
     CURLMOPT_PUSHFUNCTION(3)  callback.  The pointer will not be
     touched or used by libcurl itself, only  passed  on  to  the
     callback function.


DEFAULT

     NULL


PROTOCOLS

     HTTP(S)


EXAMPLE

     /* only allow pushes for file names starting with "push-" */
     int push_callback(CURL *parent,
                       CURL *easy,
                       size_t num_headers,
                       struct curl_pushheaders *headers,
                       void *userp)
     {
       char *headp;
       int *transfers = (int *)userp;
       FILE *out;
       headp = curl_pushheader_byname(headers, ":path");
       if(headp && !strncmp(headp, "/push-", 6)) {
         fprintf(stderr, "The PATH is %s\n", headp);

         /* save the push here */
         out = fopen("pushed-stream", "wb");

         /* write to this file */
         curl_easy_setopt(easy, CURLOPT_WRITEDATA, out);

         (*transfers)++; /* one more */

         return CURL_PUSH_OK;
       }
       return CURL_PUSH_DENY;
     }

     curl_multi_setopt(multi, CURLMOPT_PUSHFUNCTION, push_callback);
     curl_multi_setopt(multi, CURLMOPT_PUSHDATA, &counter);

libcurl 7.58.0      Last change: May 27, 2017                   1

CURLMOPT_PUSHDATA(3)curl_multi_setopt optionsCURLMOPT_PUSHDATA(3)


AVAILABILITY

     Added in 7.44.0


RETURN VALUE

     Returns  CURLM_OK  if   the   option   is   supported,   and
     CURLM_UNKNOWN_OPTION if not.


SEE ALSO

     CURLMOPT_PUSHFUNCTION(3),            CURLMOPT_PIPELINING(3),
     CURLOPT_PIPEWAIT(3), RFC7540

libcurl 7.58.0      Last change: May 27, 2017                   2


Man(1) output converted with man2html